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

baabakk / llm-ports

TypeScript LLM Abstraction Layer for Multi-Provider AI Systems. Multi-provider routing, fallback chains, USD cost gating, capability factories, tool-use security.

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

baabakk/llm-ports має індекс здоров’я 65 зі 100, що відповідає смузі «Добрий». Найвищий показник — Engineering Quality (88/100), найнижчий — Security (42/100). Останнє оновлення було 9 днів тому. Більшість нещодавньої роботи виконує один учасник.

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

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

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

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

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

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

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

Власність

BabakОсобистий обліковий запис
2 підписники32 публічні репозиторіїз бер. 2015 р.

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

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

РеєстрПакетВерсіяЗавантажень / місВерсіїОстання публікаціяТеги
npm@llm-ports/core0.1.0-alpha.281 825249 днів томуllmaitypescriptopenaianthropicollamaai-sdkgenerative-aillm-routingllm-fallbackllm-abstractionmulti-providermulti-provider-llmports-and-adaptershexagonal-architecturecost-controlcost-gatingvendor-lock-inprovider-routerai-architectureproduction-llm
npm@llm-ports/migrate0.1.0-alpha.20.138145 днів томуllm-portsmigratecodemodalpha
npm@llm-ports/capabilities0.1.0-alpha.281 387259 днів томуllmaitypescriptgenerative-aillm-portsllm-capabilitiescapabilitiesclassifyscoredraftsummarizeextractplananalyzestructured-outputzodjson-modefactory-patternreusable-promptsproduction-llm
npm@llm-ports/adapter-aider0.1.0-alpha.286519 днів томуllm-portsaideradaptersubprocessagent
npm@llm-ports/adapter-codex0.1.0-alpha.286319 днів томуllmaicodexopenaiagentsubprocessllm-portsadapter
npm@llm-ports/adapter-google0.1.0-alpha.281 076239 днів томуllmaitypescriptgooglegeminigoogle-genaivisionmultimodalports-and-adaptersllm-portsproduction-llm
npm@llm-ports/adapter-ollama0.1.0-alpha.281 086269 днів томуllmaitypescriptollamalocal-llmself-hostedllamallama3mistralphiqwengemmaai-sdkgenerative-aillm-portsllm-adapterllm-routingembeddingsmodel-managementlocal-to-cloudtool-usevisionmulti-provideroffline-llmprivacy
npm@llm-ports/adapter-openai0.1.0-alpha.282 023309 днів томуllmaitypescriptopenaiopenai-compatiblegptgpt-4gpt-4ogpt-5azure-openaigroqtogether-aifireworksdeepinfraperplexitycerebraslitellmai-sdkgenerative-aillm-portsllm-adapterllm-routingllm-fallbackembeddingstool-usefunction-callingstructured-outputvisionmulti-providercost-controlreasoning-models

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

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

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

73Добрий · 21% загального індексу
Як обчислюється оцінка
28.8/36Свіжість push — останній push 9 дн. тому
8.3/36Ритм комітів — 12/52 тижнів із комітами
18/18Обсяг комітів — 165 комітів за останній рік
0/10OpenSSF Scorecard: Maintained — project was created within the last 90 days. Please review its contents carefully
Використані вхідні дані
commits_last_year165
human_commit_share1
days_since_last_push9
active_weeks_last_year12
Як обчислюється оцінка
27/27Випускає релізи — опубліковано 82 релізів
36/36Свіжість релізів — останній реліз 13 дн. тому
27/27Ритм релізів — реліз кожні ~3,8 дн.
0/10OpenSSF Scorecard: Signed-Releases — немає даних
Використані вхідні дані
releases_count82
latest_release_tag@llm-ports/core@0.1.0-alpha.27
releases_from_tagsні
days_since_latest_release13
mean_days_between_releases3,8
Виключено з оцінювання (немає даних або не застосовно): OpenSSF Scorecard: Signed-Releases. Залишкові ваги перенормовано.

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

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

49Слабкий · 17% загального індексу
Як обчислюється оцінка
0/60Зірки — 2 зірок
0/25Форки — 0 форків
0/15Спостерігачі — 1 спостерігачів
Використані вхідні дані
forks0
stars2
watchers1
growth_stateunverified
growth_factor_pct100
growth_unverified_reasonno_history
Як обчислюється оцінка
22.5/22.5README
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
has_contributingтак
has_issue_templateні
has_code_of_conductтак
readme_badge_services
has_pull_request_templateтак
Як обчислюється оцінка
51.7/80Щомісячні завантаження — 7 563 завантажень/місяць у npm
0/20Залежні пакети в реєстрі — ця екосистема цього не повідомляє
Використані вхідні дані
packages@llm-ports/core, @llm-ports/migrate, @llm-ports/capabilities, @llm-ports/adapter-aider, @llm-ports/adapter-codex, @llm-ports/adapter-google, @llm-ports/adapter-ollama, @llm-ports/adapter-openai
dependents
ecosystemsnpm
total_downloads
monthly_downloads7 563
Виключено з оцінювання (немає даних або не застосовно): Залежні пакети в реєстрі. Залишкові ваги перенормовано.

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

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

46Слабкий · 23% загального індексу
Як обчислюється оцінка
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
Як обчислюється оцінка
26.8/42Вирішення issue — закрито 64% 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_issues13
closed_issues23
prs_merged_7d
prs_decided_7d
prs_merged_30d
prs_decided_30d
issue_closed_ratio0,639
closed_unmerged_prs0
first_time_authors_30d
first_time_prs_merged_30d
first_time_prs_decided_30d
Виключено з оцінювання (немає даних або не застосовно): Прийняття PR, newcomer_pr_acceptance. Залишкові ваги перенормовано.
Як обчислюється оцінка
10/30Підтримка власника — особистий (користувацький) обліковий запис
0/20Верифікований домен — не застосовно до користувацьких облікових записів
3.4/25Охоплення власника — 2 підписників у baabakk
23.1/25Послужний список — 32 публічних репозиторіїв, вік облікового запису ~11 р.
Використані вхідні дані
followers2
owner_typeUser
is_verified
owner_loginbaabakk
public_repos32
account_age_days4 163
Виключено з оцінювання (немає даних або не застосовно): Верифікований домен. Залишкові ваги перенормовано.

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

100Винятковий
Як обчислюється оцінка
25/25Опубліковано й доступно — 8 пакет(ів) у npm
35/35Свіжість публікацій — остання публікація 9 дн. тому
20/20Історія версій — 30 опублікованих версій
20/20Не застарілий — активний, не deprecated і не yanked
Використані вхідні дані
packages@llm-ports/core, @llm-ports/migrate, @llm-ports/capabilities, @llm-ports/adapter-aider, @llm-ports/adapter-codex, @llm-ports/adapter-google, @llm-ports/adapter-ollama, @llm-ports/adapter-openai
ecosystemsnpm
any_deprecatedні
min_days_since_publish9

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

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

88Відмінний · 19% загального індексу
Як обчислюється оцінка
24/24Процеси CI — 2 процес(ів) CI
24/24Наявні тести
16/16Конфігурація лінтера — .eslintrc.cjs
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://baabakk.github.io/llm-ports/
10/10Опис репозиторію
10/10Теми — 16 тем
10/10Wiki
Використані вхідні дані
topicsai, ai-architecture, anthropic, cost-control, generative-ai, llm, llm-abstraction, llm-fallback, llm-routing, multi-provider, ollama, openai, software-architecture, typescript, vendor-lock-in, multi-provider-ai-support
has_wikiтак
homepagehttps://baabakk.github.io/llm-ports/
has_readmeтак
has_docs_dirтак
has_descriptionтак

Безпека

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

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

Стан безпеки

28У зоні ризику
Як обчислюється оцінка
7.5/7.5Binary-Artifacts — no binaries found in the repo
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.5/2.5Ліцензія — license file detected
0/7.5Maintained — project was created within the last 90 days. Please review its contents carefully
0/5Packaging — немає даних
0/5Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 0
0/5SAST — no SAST tool detected
5/5Security-Policy — security policy file detected
0/7.5Signed-Releases — немає даних
0/7.5Token-Permissions — detected GitHub workflow tokens with excessive permissions
0/7.5Vulnerabilities — 22 existing vulnerabilities detected
Використані вхідні дані
sourceopenssf_scorecard
checks_evaluated15
scorecard_versionv5.5.0
checks_inconclusive3
scorecard_aggregate2,8
Виключено з оцінювання (немає даних або не застосовно): ci_tests, packaging, signed_releases. Залишкові ваги перенормовано.
Як обчислюється оцінка
35/35Прямі залежності без відомих сповіщень — жодна пряма залежність не має відомих сповіщень
25/25Непрямі залежності без відомих сповіщень — жодна непряма залежність не має відомих сповіщень
0/40Немає задавнених сповіщень — жодне сповіщення не має дати публікації
Використані вхідні дані
sourceosv
advisories0
affected_packages0
assessed_packages1
unassessed_packages0
affected_by_severitynone
direct_affected_packages0
Виключено з оцінювання (немає даних або не застосовно): Немає задавнених сповіщень. Залишкові ваги перенормовано. Звірено з runtime-замиканням залежностей npm:@llm-ports/core@0.1.0-alpha.28 — тим, що тягне за собою встановлення опублікованого пакета, — 1 пакетів. Досяжність не аналізується.

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

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

55Помірний · 4% загального індексу
Як обчислюється оцінка
0/45Інструкції для агентів — немає CLAUDE.md / AGENTS.md / правил редактора
0/15Машиночитана документація (llms.txt)
40/40Читабельна історія комітів — намір зазначено у 99 з 100 людських комітів (структурований заголовок або пояснювальний текст)
Використані вхідні дані
has_llms_txtні
legible_history_share0,99
agent_instruction_files
agent_instruction_max_bytes
Як обчислюється оцінка
0/18Розгортання однією командою
22/22Автоматизовані тести
11/11Конфігурація лінтера / форматера — .eslintrc.cjs
11/11Статична перевірка типів — examples/agent-with-approval/tsconfig.json, examples/basic/tsconfig.json, examples/email-triage/tsconfig.json, examples/extract-from-pdf/tsconfig.json, examples/local-with-ollama/tsconfig.json, examples/migrate-from-vercel-ai/tsconfig.json, examples/multi-provider/tsconfig.json, examples/streaming-chat/tsconfig.json, examples/with-onretry/tsconfig.json, packages/adapter-aider/tsconfig.json, packages/adapter-anthropic/tsconfig.json, packages/adapter-codex/tsconfig.json, packages/adapter-contract-tests/tsconfig.json, packages/adapter-google/tsconfig.json, packages/adapter-ollama/tsconfig.json, packages/adapter-openai/tsconfig.json, packages/adapter-vercel/tsconfig.json, packages/benchmarks/tsconfig.json, packages/capabilities/tsconfig.json, packages/consumer-type-check/tsconfig.json, packages/core/tsconfig.json, packages/migrate/tsconfig.json, packages/observability-contract/tsconfig.json
10/10Відтворюване середовище — lockfile
0/10Підтверджена практика роботи з агентами — серед останніх 100 комітів немає створених агентом
0/8Автоматизоване супроводження — автоматичних оновлень залежностей не виявлено
0/10OpenSSF Scorecard: Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 0
Використані вхідні дані
has_nixні
has_testsтак
lockfilespnpm-lock.yaml
has_dockerfileні
typed_languageтак
bootstrap_files
has_devcontainerні
has_linter_configтак
typecheck_configsexamples/agent-with-approval/tsconfig.json, examples/basic/tsconfig.json, examples/email-triage/tsconfig.json, examples/extract-from-pdf/tsconfig.json, examples/local-with-ollama/tsconfig.json, examples/migrate-from-vercel-ai/tsconfig.json, examples/multi-provider/tsconfig.json, examples/streaming-chat/tsconfig.json, examples/with-onretry/tsconfig.json, packages/adapter-aider/tsconfig.json, packages/adapter-anthropic/tsconfig.json, packages/adapter-codex/tsconfig.json, packages/adapter-contract-tests/tsconfig.json, packages/adapter-google/tsconfig.json, packages/adapter-ollama/tsconfig.json, packages/adapter-openai/tsconfig.json, packages/adapter-vercel/tsconfig.json, packages/benchmarks/tsconfig.json, packages/capabilities/tsconfig.json, packages/consumer-type-check/tsconfig.json, packages/core/tsconfig.json, packages/migrate/tsconfig.json, packages/observability-contract/tsconfig.json
agent_commit_share0
toolchain_manifests
dependency_bot_commit_share0
Як обчислюється оцінка
45/45Типізований код — TypeScript (статично типізована)
54.8/55Керовані розміри файлів — 1/262 файлів вихідного коду понад 60 КБ
Використані вхідні дані
primary_languageTypeScript
largest_source_bytes82 975
source_files_sampled262
oversized_source_files1
Як обчислюється оцінка
0/40Схема API (OpenAPI/GraphQL/proto)
0/20Сервер MCP
40/40Придатні до запуску приклади — examples
Використані вхідні дані
example_dirsexamples
has_mcp_signalні
api_schema_files

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

2зірок GitHub
1контриб'юторів
165комітів за останні 12 місяців
9днів від останнього пушу
82релізів
1бас-фактор
13відкритих issue
npmпакетних екосистем

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

  • 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

Докладніше

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

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

10Binary-Artifactsno binaries found in the repo
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
10Licenselicense file detected
0Maintainedproject was created within the last 90 days. Please review its contents carefully
н/дPackagingpackaging workflow not detected
0Pinned-Dependenciesdependency not pinned by hash detected -- score normalized to 0
0SASTno SAST tool detected
10Security-Policysecurity policy file detected
н/дSigned-Releasesno releases found
0Token-Permissionsdetected GitHub workflow tokens with excessive permissions
0Vulnerabilities22 existing vulnerabilities detected
Прямі залежності 21
РеєстрПакетОбмеження версіїМаніфест
npm@anthropic-ai/sdk^0.32.1packages/adapter-anthropic/package.json
npm@llm-ports/coreworkspace:*packages/adapter-anthropic/package.json
npmzod-to-json-schema^3.24.1packages/adapter-anthropic/package.json
npm@llm-ports/coreworkspace:*packages/adapter-contract-tests/package.json
npmvitest^2.1.4packages/adapter-contract-tests/package.json
npmzod^3.23.0packages/adapter-contract-tests/package.json
npm@llm-ports/coreworkspace:*packages/adapter-google/package.json
npmzod-to-json-schema^3.23.5packages/adapter-google/package.json
npm@llm-ports/coreworkspace:*packages/adapter-ollama/package.json
npmollama^0.5.10packages/adapter-ollama/package.json
npm@llm-ports/coreworkspace:*packages/adapter-openai/package.json
npmopenai^4.73.0packages/adapter-openai/package.json
npmzod-to-json-schema^3.24.1packages/adapter-openai/package.json
npm@llm-ports/coreworkspace:*packages/adapter-vercel/package.json
npmai^4.3.19packages/adapter-vercel/package.json
npm@llm-ports/coreworkspace:*packages/capabilities/package.json
npm@llm-ports/coreworkspace:*packages/consumer-type-check/package.json
npm@llm-ports/capabilitiesworkspace:*packages/consumer-type-check/package.json
npmzod^3.25.76packages/consumer-type-check/package.json
npmjsonrepair^3.14.0packages/core/package.json
npmnanoid^5.0.9packages/observability-contract/package.json
Усі залежності не зібрано

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

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

Встановлення npm:@llm-ports/core@0.1.0-alpha.28 тягне 1 пакетів, прямих і транзитивних: 0 мають відомі сповіщення, з них 0 — прямі залежності.

Жодне відоме сповіщення не стосується оцінених залежностей.

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

Звіт у форматі JSON машиночитний
{
  "data": {
    "repo": {
      "topics": [
        "ai",
        "ai-architecture",
        "anthropic",
        "cost-control",
        "generative-ai",
        "llm",
        "llm-abstraction",
        "llm-fallback",
        "llm-routing",
        "multi-provider",
        "ollama",
        "openai",
        "software-architecture",
        "typescript",
        "vendor-lock-in",
        "multi-provider-ai-support"
      ],
      "is_fork": false,
      "size_kb": 4580,
      "has_wiki": true,
      "homepage": "https://baabakk.github.io/llm-ports/",
      "languages": {
        "JavaScript": 14014,
        "TypeScript": 1664309
      },
      "pushed_at": "2026-07-22T12:53:03Z",
      "created_at": "2026-05-06T00:38:41Z",
      "owner_type": "User",
      "updated_at": "2026-07-22T12:51:03Z",
      "description": "TypeScript LLM Abstraction Layer for Multi-Provider AI Systems. Multi-provider routing, fallback chains, USD cost gating, capability factories, tool-use security.",
      "is_archived": false,
      "is_disabled": false,
      "license_spdx": "MIT",
      "default_branch": "main",
      "license_spdx_raw": "MIT",
      "primary_language": "TypeScript",
      "significant_languages": [
        "TypeScript"
      ]
    },
    "owner": {
      "blog": null,
      "name": "Babak",
      "type": "User",
      "login": "baabakk",
      "company": null,
      "location": null,
      "followers": 2,
      "avatar_url": "https://avatars.githubusercontent.com/u/11369431?v=4",
      "created_at": "2015-03-07T22:22:52Z",
      "is_verified": null,
      "public_repos": 32,
      "account_age_days": 4163
    },
    "license": {
      "state": "standard",
      "spdx_id": "MIT",
      "raw_spdx": "MIT",
      "file_present": true,
      "scorecard_found": true,
      "profile_has_license": true
    },
    "activity": {
      "releases": [
        {
          "tag": "@llm-ports/core@0.1.0-alpha.27",
          "kind": "other",
          "published_at": "2026-07-17T23:55:25Z"
        },
        {
          "tag": "@llm-ports/capabilities@0.1.0-alpha.26.1",
          "kind": "other",
          "published_at": "2026-07-03T07:57:15Z"
        },
        {
          "tag": "v0.1.0-alpha.26",
          "kind": "prerelease",
          "published_at": "2026-07-02T23:18:53Z"
        },
        {
          "tag": "v0.1.0-alpha.25",
          "kind": "prerelease",
          "published_at": "2026-07-02T22:45:56Z"
        },
        {
          "tag": "v0.1.0-alpha.24",
          "kind": "prerelease",
          "published_at": "2026-06-25T01:58:21Z"
        },
        {
          "tag": "v0.1.0-alpha.23",
          "kind": "prerelease",
          "published_at": "2026-06-25T01:12:11Z"
        },
        {
          "tag": "v0.1.0-alpha.22",
          "kind": "prerelease",
          "published_at": "2026-06-19T15:58:14Z"
        },
        {
          "tag": "v0.1.0-alpha.21",
          "kind": "prerelease",
          "published_at": "2026-06-19T04:52:32Z"
        },
        {
          "tag": "@llm-ports/core@0.1.0-alpha.20.1",
          "kind": "other",
          "published_at": "2026-06-15T23:26:22Z"
        },
        {
          "tag": "@llm-ports/core@0.1.0-alpha.20",
          "kind": "other",
          "published_at": "2026-06-13T20:39:54Z"
        },
        {
          "tag": "@llm-ports/core@0.1.0-alpha.19.1",
          "kind": "other",
          "published_at": "2026-06-12T22:59:14Z"
        },
        {
          "tag": "@llm-ports/core@0.1.0-alpha.19",
          "kind": "other",
          "published_at": "2026-06-12T19:24:01Z"
        },
        {
          "tag": "@llm-ports/core@0.1.0-alpha.18",
          "kind": "other",
          "published_at": "2026-06-05T09:14:05Z"
        },
        {
          "tag": "@llm-ports/core@0.1.0-alpha.17",
          "kind": "other",
          "published_at": "2026-06-05T07:18:43Z"
        },
        {
          "tag": "@llm-ports/adapter-openai@0.1.0-alpha.16",
          "kind": "other",
          "published_at": "2026-05-30T20:38:02Z"
        },
        {
          "tag": "@llm-ports/adapter-openai@0.1.0-alpha.15",
          "kind": "other",
          "published_at": "2026-05-27T08:15:35Z"
        },
        {
          "tag": "@llm-ports/adapter-openai@0.1.0-alpha.14",
          "kind": "other",
          "published_at": "2026-05-27T04:17:21Z"
        },
        {
          "tag": "@llm-ports/adapter-vercel@0.1.0-alpha.13",
          "kind": "other",
          "published_at": "2026-05-27T03:13:47Z"
        },
        {
          "tag": "@llm-ports/adapter-ollama@0.1.0-alpha.13",
          "kind": "other",
          "published_at": "2026-05-27T03:13:46Z"
        },
        {
          "tag": "@llm-ports/adapter-google@0.1.0-alpha.13",
          "kind": "other",
          "published_at": "2026-05-27T03:13:45Z"
        },
        {
          "tag": "@llm-ports/adapter-anthropic@0.1.0-alpha.13",
          "kind": "other",
          "published_at": "2026-05-27T03:13:43Z"
        },
        {
          "tag": "@llm-ports/adapter-openai@0.1.0-alpha.13",
          "kind": "other",
          "published_at": "2026-05-27T03:13:41Z"
        },
        {
          "tag": "@llm-ports/capabilities@0.1.0-alpha.13",
          "kind": "other",
          "published_at": "2026-05-27T03:13:39Z"
        },
        {
          "tag": "@llm-ports/core@0.1.0-alpha.13",
          "kind": "other",
          "published_at": "2026-05-27T03:13:38Z"
        },
        {
          "tag": "@llm-ports/adapter-vercel@0.1.0-alpha.12",
          "kind": "other",
          "published_at": "2026-05-27T02:04:39Z"
        },
        {
          "tag": "@llm-ports/adapter-openai@0.1.0-alpha.12",
          "kind": "other",
          "published_at": "2026-05-27T02:04:34Z"
        },
        {
          "tag": "@llm-ports/capabilities@0.1.0-alpha.12",
          "kind": "other",
          "published_at": "2026-05-27T02:04:32Z"
        },
        {
          "tag": "@llm-ports/core@0.1.0-alpha.12",
          "kind": "other",
          "published_at": "2026-05-27T02:04:31Z"
        },
        {
          "tag": "@llm-ports/adapter-ollama@0.1.0-alpha.12",
          "kind": "other",
          "published_at": "2026-05-27T02:04:38Z"
        },
        {
          "tag": "@llm-ports/adapter-google@0.1.0-alpha.12",
          "kind": "other",
          "published_at": "2026-05-27T02:04:36Z"
        },
        {
          "tag": "@llm-ports/adapter-anthropic@0.1.0-alpha.12",
          "kind": "other",
          "published_at": "2026-05-27T02:04:35Z"
        },
        {
          "tag": "@llm-ports/adapter-vercel@0.1.0-alpha.11",
          "kind": "other",
          "published_at": "2026-05-26T11:27:47Z"
        },
        {
          "tag": "@llm-ports/adapter-openai@0.1.0-alpha.11",
          "kind": "other",
          "published_at": "2026-05-26T11:27:43Z"
        },
        {
          "tag": "@llm-ports/adapter-ollama@0.1.0-alpha.11",
          "kind": "other",
          "published_at": "2026-05-26T11:27:46Z"
        },
        {
          "tag": "@llm-ports/adapter-google@0.1.0-alpha.11",
          "kind": "other",
          "published_at": "2026-05-26T11:27:44Z"
        },
        {
          "tag": "@llm-ports/adapter-anthropic@0.1.0-alpha.11",
          "kind": "other",
          "published_at": "2026-05-26T11:27:42Z"
        },
        {
          "tag": "@llm-ports/adapter-anthropic@0.1.0-alpha.10",
          "kind": "other",
          "published_at": "2026-05-26T10:54:44Z"
        },
        {
          "tag": "@llm-ports/core@0.1.0-alpha.9",
          "kind": "other",
          "published_at": "2026-05-26T10:31:49Z"
        },
        {
          "tag": "@llm-ports/adapter-vercel@0.1.0-alpha.9",
          "kind": "other",
          "published_at": "2026-05-26T10:31:59Z"
        },
        {
          "tag": "@llm-ports/adapter-ollama@0.1.0-alpha.9",
          "kind": "other",
          "published_at": "2026-05-26T10:31:57Z"
        },
        {
          "tag": "@llm-ports/adapter-google@0.1.0-alpha.9",
          "kind": "other",
          "published_at": "2026-05-26T10:31:56Z"
        },
        {
          "tag": "@llm-ports/adapter-anthropic@0.1.0-alpha.9",
          "kind": "other",
          "published_at": "2026-05-26T10:31:54Z"
        },
        {
          "tag": "@llm-ports/adapter-openai@0.1.0-alpha.9",
          "kind": "other",
          "published_at": "2026-05-26T10:31:52Z"
        },
        {
          "tag": "@llm-ports/capabilities@0.1.0-alpha.9",
          "kind": "other",
          "published_at": "2026-05-26T10:31:51Z"
        },
        {
          "tag": "@llm-ports/adapter-openai@0.1.0-alpha.8",
          "kind": "other",
          "published_at": "2026-05-26T06:45:58Z"
        },
        {
          "tag": "@llm-ports/adapter-anthropic@0.1.0-alpha.8",
          "kind": "other",
          "published_at": "2026-05-26T06:45:56Z"
        },
        {
          "tag": "@llm-ports/adapter-vercel@0.1.0-alpha.8",
          "kind": "other",
          "published_at": "2026-05-26T06:45:59Z"
        },
        {
          "tag": "@llm-ports/adapter-google@0.1.0-alpha.8",
          "kind": "other",
          "published_at": "2026-05-26T06:46:01Z"
        },
        {
          "tag": "@llm-ports/adapter-ollama@0.1.0-alpha.8",
          "kind": "other",
          "published_at": "2026-05-26T06:46:00Z"
        },
        {
          "tag": "@llm-ports/adapter-google@0.1.0-alpha.7",
          "kind": "other",
          "published_at": "2026-05-23T22:48:33Z"
        },
        {
          "tag": "@llm-ports/adapter-ollama@0.1.0-alpha.7",
          "kind": "other",
          "published_at": "2026-05-23T22:48:32Z"
        },
        {
          "tag": "@llm-ports/adapter-vercel@0.1.0-alpha.7",
          "kind": "other",
          "published_at": "2026-05-23T22:48:31Z"
        },
        {
          "tag": "@llm-ports/adapter-openai@0.1.0-alpha.7",
          "kind": "other",
          "published_at": "2026-05-23T22:48:30Z"
        },
        {
          "tag": "@llm-ports/adapter-anthropic@0.1.0-alpha.7",
          "kind": "other",
          "published_at": "2026-05-23T22:48:29Z"
        },
        {
          "tag": "@llm-ports/capabilities@0.1.0-alpha.7",
          "kind": "other",
          "published_at": "2026-05-23T22:48:28Z"
        },
        {
          "tag": "@llm-ports/core@0.1.0-alpha.7",
          "kind": "other",
          "published_at": "2026-05-23T22:48:27Z"
        },
        {
          "tag": "@llm-ports/adapter-ollama@0.1.0-alpha.6",
          "kind": "other",
          "published_at": "2026-05-23T11:14:26Z"
        },
        {
          "tag": "@llm-ports/adapter-vercel@0.1.0-alpha.6",
          "kind": "other",
          "published_at": "2026-05-23T11:14:25Z"
        },
        {
          "tag": "@llm-ports/adapter-openai@0.1.0-alpha.6",
          "kind": "other",
          "published_at": "2026-05-23T11:14:24Z"
        },
        {
          "tag": "@llm-ports/capabilities@0.1.0-alpha.6",
          "kind": "other",
          "published_at": "2026-05-23T11:14:21Z"
        },
        {
          "tag": "@llm-ports/core@0.1.0-alpha.6",
          "kind": "other",
          "published_at": "2026-05-23T11:14:20Z"
        },
        {
          "tag": "@llm-ports/adapter-google@0.1.0-alpha.6",
          "kind": "other",
          "published_at": "2026-05-23T11:14:28Z"
        },
        {
          "tag": "@llm-ports/adapter-anthropic@0.1.0-alpha.6",
          "kind": "other",
          "published_at": "2026-05-23T11:14:22Z"
        },
        {
          "tag": "@llm-ports/adapter-google@0.1.0-alpha.5",
          "kind": "other",
          "published_at": "2026-05-21T04:26:13Z"
        },
        {
          "tag": "@llm-ports/adapter-ollama@0.1.0-alpha.5",
          "kind": "other",
          "published_at": "2026-05-21T04:26:12Z"
        },
        {
          "tag": "@llm-ports/adapter-vercel@0.1.0-alpha.5",
          "kind": "other",
          "published_at": "2026-05-21T04:26:10Z"
        },
        {
          "tag": "@llm-ports/adapter-openai@0.1.0-alpha.5",
          "kind": "other",
          "published_at": "2026-05-21T04:26:09Z"
        },
        {
          "tag": "@llm-ports/adapter-anthropic@0.1.0-alpha.5",
          "kind": "other",
          "published_at": "2026-05-21T04:26:08Z"
        },
        {
          "tag": "@llm-ports/capabilities@0.1.0-alpha.5",
          "kind": "other",
          "published_at": "2026-05-21T04:26:07Z"
        },
        {
          "tag": "@llm-ports/core@0.1.0-alpha.5",
          "kind": "other",
          "published_at": "2026-05-21T04:26:06Z"
        },
        {
          "tag": "@llm-ports/adapter-ollama@0.1.0-alpha.4",
          "kind": "other",
          "published_at": "2026-05-21T02:51:52Z"
        },
        {
          "tag": "@llm-ports/adapter-vercel@0.1.0-alpha.4",
          "kind": "other",
          "published_at": "2026-05-21T02:51:51Z"
        },
        {
          "tag": "@llm-ports/adapter-openai@0.1.0-alpha.4",
          "kind": "other",
          "published_at": "2026-05-21T02:51:50Z"
        },
        {
          "tag": "@llm-ports/adapter-anthropic@0.1.0-alpha.4",
          "kind": "other",
          "published_at": "2026-05-21T02:51:49Z"
        },
        {
          "tag": "@llm-ports/capabilities@0.1.0-alpha.4",
          "kind": "other",
          "published_at": "2026-05-21T02:51:48Z"
        },
        {
          "tag": "@llm-ports/core@0.1.0-alpha.4",
          "kind": "other",
          "published_at": "2026-05-21T02:51:47Z"
        },
        {
          "tag": "@llm-ports/adapter-ollama@0.1.0-alpha.3",
          "kind": "other",
          "published_at": "2026-05-21T01:15:58Z"
        },
        {
          "tag": "@llm-ports/adapter-vercel@0.1.0-alpha.3",
          "kind": "other",
          "published_at": "2026-05-21T01:15:57Z"
        },
        {
          "tag": "@llm-ports/adapter-openai@0.1.0-alpha.3",
          "kind": "other",
          "published_at": "2026-05-21T01:15:56Z"
        },
        {
          "tag": "@llm-ports/adapter-anthropic@0.1.0-alpha.3",
          "kind": "other",
          "published_at": "2026-05-21T01:15:54Z"
        },
        {
          "tag": "@llm-ports/capabilities@0.1.0-alpha.3",
          "kind": "other",
          "published_at": "2026-05-21T01:15:53Z"
        },
        {
          "tag": "@llm-ports/core@0.1.0-alpha.3",
          "kind": "other",
          "published_at": "2026-05-21T01:15:52Z"
        }
      ],
      "recent_commits": [
        {
          "oid": "d1ed31b72bd6c237f280eeac049113d385a61a79",
          "body": "Runs `pnpm changeset version` against the alpha-28\nchangeset entry. All non-ignored @llm-ports/* packages\nbumped from alpha.27 → alpha.28 uniformly per the\n`linked` config. @llm-ports/migrate stays at alpha.20.1\nvia a new addition to the changesets `ignore` list\n(migrate is on an independent release\n[…]\n8 §5.1).\n\nVerification: `pnpm -r --workspace-concurrency=1 build`\ngreen; full test suite green (~1400 tests across\nadapter-aider 26/26, adapter-codex 41/41, and every\nother package's suite unchanged).",
          "is_bot": false,
          "headline": "chore(release): version @llm-ports/* to 0.1.0-alpha.28",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-07-22T12:48:15Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "592f79b2f5f939bf306a8f05e0b9d79095375b19",
          "body": "…dapter-aider\n\nThe initial adapter.test.ts suites covered LLMPort shape, error paths,\noptions passthrough, and observability *started*-event emission — but\nthe CLI arg construction and codex's --json parse path were untested.\nIf codex ever renamed a flag or changed its --json event shape (or\naider i\n[…]\ne shape as codex.\n\nCombined results:\n- adapter-codex: 41/41 passing (12 shape + 29 internals).\n- adapter-aider: 26/26 passing (12 shape + 14 internals).\n\nBoth packages rebuild clean (ESM + CJS + DTS).",
          "is_bot": false,
          "headline": "test(alpha.28-prep): unit-test internal helpers for adapter-codex + a…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-07-22T12:28:08Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "29ad0be72c6484e304bf12844b5ce1a3a0686c80",
          "body": "…er adapter (Shape A passthrough)\n\nAdds @llm-ports/adapter-aider@0.1.0-alpha.28. Wraps the aider CLI's\n`aider --no-stream --yes-always --message \"<prompt>\"` invocation as\nan in-process LLMPort.runAgent implementation.\n\nShape A (passthrough governance): the operator supplies aider with\nits own provid\n[…]\n —\nconstructor, unsupported-method errors, missing-workingDirectory\nerror, empty-messages error, smoke runAgent through node-as-mock-cli,\nobservability-event emission, and adapter options passthrough.",
          "is_bot": false,
          "headline": "feat(alpha.28-prep): @llm-ports/adapter-aider — subprocess-driven aid…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-07-22T11:49:36Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "bce1d5475cd2ebbaf5acc84f37711c77718d6b49",
          "body": "…ex adapter (Shape A passthrough)\n\nAdds @llm-ports/adapter-codex@0.1.0-alpha.28. Wraps codex-cli's\n`codex exec --json` as an in-process LLMPort.runAgent implementation.\n\nShape A (passthrough governance): the operator supplies codex with its\nown OpenAI credentials via env vars or ~/.codex/auth.toml. \n[…]\nructor shape, unsupported-method\nerrors, missing-workingDirectory error, empty-messages error, smoke\nrunAgent through node-as-mock-codex, observability-event emission,\nand adapter options passthrough.",
          "is_bot": false,
          "headline": "feat(alpha.28-prep): @llm-ports/adapter-codex — subprocess-driven cod…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-07-22T11:44:57Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "8eed89a6a03c58c51df99d95759e50f371affc98",
          "body": "…@llm-ports/core (§4.2)\n\nThe caller-provided context ingress mechanism. Consumers who want to\nattach correlation, W3C Trace Context, Baggage, attributes, or an\nHMAC fingerprint key to every call flowing through a port wrap it\nonce at the workflow root:\n\n  const scoped = withObservabilityContext(port\n[…]\nions.\n\nProvenance: Cross-consumer review pass 2026-07-21. Plan 58 v0.4 §4.2.\nThis is the last step of the observability-contract deliverables.\nAdapter-aider and adapter-codex (steps 5k + 5l) are next.",
          "is_bot": false,
          "headline": "feat(alpha.28-prep): withObservabilityContext scoped-port wrapper in …",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-07-22T11:35:22Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "c4ac431a0fd5fb9ef0de74238b85e9e2bf8a78e0",
          "body": "…ort callers (§4.13)\n\nThe convenience API that non-port callers (subprocess-driven agent\nruntimes, custom orchestrators, framework middleware) use to emit\nconformant observability events without pulling in @llm-ports/core.\n\nPublic exports:\n\n- EmitterConfig: static setup { source, sink, spec_version?\n[…]\nnew). All pass.\n\nProvenance: Cross-consumer review pass 2026-07-21. Plan 58 v0.4 §4.13.\nThis commit is what closes the \"non-port caller can emit conformant\nevents\" property to a runtime demonstration.",
          "is_bot": false,
          "headline": "feat(alpha.28-prep): observability-contract emitter helpers for non-p…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-07-22T11:31:37Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "a73e405b2a004149b3b6aa12b9d540dfc965538f",
          "body": "…r every type\n\nRuntime validators for every type in the contract. Downstream sinks\n(ClickHouse ingestion, OTel adapter, consumer-supplied storage) call\n.parse() on incoming events to reject malformed payloads at the sink\nboundary.\n\nSchemas mirror their TypeScript types:\n\nFoundation:\n- eventSourceSch\n[…]\n; +49 new). All pass.\n\nProvenance: Cross-consumer review pass 2026-07-21. Plan 58 v0.4 §7.1\nrequired schema validation as part of the contract-conformance\nsuccess criteria; this commit satisfies that.",
          "is_bot": false,
          "headline": "feat(alpha.28-prep): observability-contract Zod validation schemas fo…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-07-22T11:28:48Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "93e66161ded673372cc714c8ce3cff4316af4de1",
          "body": "…cy contract\n\nThe formal privacy contract. Every emitter reads a CapturePolicy at\nconstruction time and decides how much of each event's payload lands\non the wire. Sinks may LOWER capture (drop fields the policy allowed)\nbut MUST NOT RAISE it. Defense-in-depth.\n\nCapturePolicy shape:\n- content: \"none\n[…]\nservability-contract tests: 225 (was 192; +33 new). All pass.\n\nProvenance: Cross-consumer review pass 2026-07-21. Plan 58 v0.4 §4.10.\nOutsider critique §10 informed the formal privacy-contract design.",
          "is_bot": false,
          "headline": "feat(alpha.28-prep): observability-contract §4.10 CapturePolicy priva…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-07-22T11:24:05Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "22b7d4f2c41b4084a7d0629bf24a69483ab2d5b1",
          "body": "…uationTarget union + score union\n\nThe write surface for post-hoc scores that consumers attach to\nobservability data. Evaluations arrive LATE: an LLM-judge score runs\noffline; a human annotator labels an interaction hours later; a\ndataset replay produces retrospective scores days after the original\n\n[…]\nt tests: 192 (was 169; +23 new). All pass.\n\nProvenance: Cross-consumer review pass 2026-07-21. Plan 58 v0.4 §4.9.\nOutsider critique §7 informed the target-union + score-union + dedup\ndesign decisions.",
          "is_bot": false,
          "headline": "feat(alpha.28-prep): observability-contract §4.9 EvaluationRef + Eval…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-07-22T11:21:27Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "8b963517c6140b6d3740af43c59cc9d847441e09",
          "body": "… golden vectors\n\nSecond half of the RequestFingerprint deliverable. Assembles the\ncanonicalization + hash primitives from the previous commit into the\npublic API, and ships golden vectors that pin the exact byte outputs\nfor cross-implementation validation.\n\nRequestFingerprint shape:\n- message_hash:\n[…]\n +35\n  new). All pass.\n\nProvenance: Cross-consumer review pass 2026-07-21. Plan 58 v0.4 §4.6.\nOutsider critique §7.1 asked for golden vectors; §6 asked for the\ntwo-hash + canonicalization spec design.",
          "is_bot": false,
          "headline": "feat(alpha.28-prep): observability-contract §4.6 RequestFingerprint +…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-07-22T11:18:46Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "e482f0fae9a55f14aff52f9727560dba8298a6fb",
          "body": "…ash primitives\n\nFirst half of the RequestFingerprint deliverable. Adds the normative\ncanonicalization spec (v1) plus the hash primitives that produce the\ntwo fingerprint hashes.\n\nCanonicalization spec v1 rules (canonicalize.ts):\n\n1. Key ordering: JSON object keys sorted lexicographically at every\n \n[…]\nimitives into the RequestFingerprint\ntype + computeRequestFingerprint helper + golden vectors JSON pinning\nthe exact byte output.\n\nProvenance: Cross-consumer review pass 2026-07-21. Plan 58 v0.4 §4.6.",
          "is_bot": false,
          "headline": "feat(alpha.28-prep): observability-contract §4.6 canonicalization + h…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-07-22T11:13:34Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "1922b97dbdad995bedf4e08feb5a9bd25e6970b1",
          "body": "Replaces the CacheStatsPlaceholder from the lifecycle commit with the\nfull nested shape:\n\n- provider_cache?: ProviderCacheStats\n- semantic_cache?: SemanticCacheStats\n\nProviderCacheStats:\n- status: \"hit\" | \"miss\" | \"partial\" | \"ineligible\" | \"unknown\"\n- read_input_tokens? (Anthropic cache_read, OpenA\n[…]\n Total observability-contract tests: 84 (was 58; +26 new). All pass.\n\nProvenance: Cross-consumer review pass 2026-07-21. Plan 58 v0.4 §4.5.\nOutsider critique §8 informed the nested-with-status design.",
          "is_bot": false,
          "headline": "feat(alpha.28-prep): observability-contract §4.5 CacheStats nested shape",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-07-22T11:09:26Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "e2efa68f6f7c3b41e1dc4ec383b0686aeaee63b4",
          "body": "…useCategory rollup\n\nReplaces the ErrorInfoPlaceholder from the lifecycle commit with the\nfull shape:\n\n- error_type: string form of the typed error class\n- message?: human-readable, redactable per CapturePolicy\n- retryable: boolean (same-provider retry may succeed)\n- fallback_worthy: boolean (walk t\n[…]\n completeness of the\n  ERROR_TYPE_TO_CATEGORY static table.\n- Total observability-contract tests: 58 (was 40; +18 new). All pass.\n\nProvenance: Cross-consumer review pass 2026-07-21. Plan 58 v0.4 §4.4.",
          "is_bot": false,
          "headline": "feat(alpha.28-prep): observability-contract §4.4 ErrorInfo shape + Ca…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-07-22T11:06:33Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "bc29c4379e8faf5d871e6eb1e05c30bf38cb16d4",
          "body": "…4.7 agent-step events\n\nAdds thirteen event types covering the complete operation lifecycle:\n\nNine core lifecycle events per Plan 58 v0.4 §4.3:\n- llm.operation.started\n- llm.attempt.started\n- llm.attempt.retry_scheduled\n- llm.fallback.selected\n- llm.attempt.failed\n- llm.attempt.completed\n- llm.opera\n[…]\n ending with an OPERATION_TERMINATOR_TYPES\n    event\n- Total observability-contract tests: 40 (was 21; +19 new). All pass.\n\nProvenance: Cross-consumer review pass 2026-07-21. Plan 58 v0.4 §4.3 + §4.7.",
          "is_bot": false,
          "headline": "feat(alpha.28-prep): observability-contract §4.3 lifecycle events + §…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-07-22T11:03:22Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "eef5de19928300d648c37e3c70dc3f204bdaafa5",
          "body": "…1.0-alpha.28 — foundation types (envelope, correlation, sink, IDs)\n\nFirst landmark commit for Plan 58 v0.4 §5.1 alpha.28 contract foundation.\nBootstraps the standalone data contract package that non-port callers\n(ADW's ClaudeCodeDriver subprocess path, custom agent runtimes, etc.)\nimport to emit co\n[…]\n total workspace tests: 934 (was 913 pre-commit; +21 new).\n\nProvenance: Cross-consumer review pass 2026-07-21. Plan 58 v0.4 approved\n2026-07-21T18:45:46 -07:00, §5.1 alpha.28 contract foundation only.",
          "is_bot": false,
          "headline": "feat(alpha.28-prep): new package @llm-ports/observability-contract@0.…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-07-22T05:20:13Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "e2934f72e68ba09581a804043de7321f9574f882",
          "body": "…es on invalid_enum_value before retry\n\nModel-emitted Unicode confusables of ASCII delimiter characters (U+2010..U+2015\nhyphens, U+2018/U+2019 curly single quotes, U+201C/U+201D curly double quotes,\nU+00A0 non-breaking space and other Unicode spaces, U+FF0D fullwidth\nhyphen-minus) silently broke Zod\n[…]\nepair-validation tests pass (was 33; +13 new).\n\nConsumer-side origin: ADW TD-LLM-20 + BEPA\nTD-LLMPORTS-EXTRACTJSON-UNICODE-CONFUSABLE-NORMALIZATION.\n\nProvenance: Cross-consumer review pass 2026-07-21.",
          "is_bot": false,
          "headline": "fix(TD-LLMP-18): attemptValidationRepair normalizes Unicode confusabl…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-07-22T05:13:18Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "24194b775db008d7eb34adee376040dfdd5a196f",
          "body": "… isolates local JS runtime errors as AdapterInternalError\n\nTwo-part fix for the ADW-reported bug: runAgent throws raw TypeError\nwhen tools omitted, and local TypeErrors get misclassified as\nServiceUnavailableError triggering futile chain-wide failover.\n\nPart 1: defensive tools normalization (fixes \n[…]\nelopment_TechDebt.md:1125-1141)\nplus BEPA TD-LLMPORTS-TYPEERROR-MISCLASSIFIED-AS-SERVICE-UNAVAILABLE\n(BEPA-side sibling tracking the same exposure).\n\nProvenance: Cross-consumer review pass 2026-07-21.",
          "is_bot": false,
          "headline": "fix(TD-LLMP-17): runAgent tools defensive default + wrapProviderError…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-07-22T05:10:35Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "9647f043e47098b255dcb98fbb133fd911dc3bfd",
          "body": "…ouldFallback (TD-LLMP-19)\n\nCanonical walk-table policy from the 2026-07-21 cross-consumer review pass,\nexported as a single-function predicate consumers can wire into\nruntimeFallback config. Codifies the outcome of the review; supersedes\nhand-rolled per-consumer classifiers.\n\nWalk-worthy (returns t\n[…]\nrMatchers.default policy\n(with two exceptions: ImageTooLargeError and ContentBlockUnsupportedError\nnow walk correctly, closing a small ambient bug).\n\nProvenance: Cross-consumer review pass 2026-07-21.",
          "is_bot": false,
          "headline": "feat(alpha.28-prep): publish canonical walk-table policy as defaultSh…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-07-22T05:07:22Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "c1f0841dc1da9aba17c342e574880bb5ffbed136",
          "body": "…Error, ProviderMalformed400Error, AdapterInternalError\n\nFoundational building block for alpha.28 (Plan 58 §4.4 ErrorInfo shape +\nwalk-table policy). All three classes are prerequisites for:\n\n- TD-LLMP-17 (runAgent tools guard + local-throw isolation): adapter code\n  wraps only the provider-call blo\n[…]\npty-body 400 detection\npath already outlined in the DeepInfra + Cerebras production reports. Those\nchanges ship in subsequent alpha.28-prep commits.\n\nProvenance: Cross-consumer review pass 2026-07-21.",
          "is_bot": false,
          "headline": "feat(alpha.28-prep): add 3 new typed error classes — CreditExhaustion…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-07-22T05:04:12Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "993db1bf4a886402e035ecadfae800a54324ffeb",
          "body": "…textWindowExceededError and ContentPolicyViolationError\n\nThe alpha.28 pre-work batch starts with TD-LLMP-16 (from the cross-consumer\nreview pass 2026-07-21). Previously, wrapProviderError construct the two\nmodel-scoped BadRequest subclasses with a hardcoded \"(unknown)\" placeholder\neven when the ada\n[…]\n-side origin: BEPA TD-LLMPORTS-DEEPINFRA-CONTEXT-EXCEEDED-MODEL-UNKNOWN-AND-SILENT-HANG-ON-RETRY Bug 1 (filed 2026-07-21T03:06:38 in BEPA's TD log).\n\nProvenance: Cross-consumer review pass 2026-07-21.",
          "is_bot": false,
          "headline": "fix(TD-LLMP-16): propagate modelId through wrapProviderError into Con…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-07-22T02:16:56Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "f0147f65cabc9a0da63fe50796747ff534cf9567",
          "body": "…sk requirements + provider capabilities + boot-time chain resolution)\n\nFiled after BEPA's 2026-07-21T09:35 UTC selector-compile incident: task\ntype had no explicit LLM_TASK_ROUTE_SELECTOR_COMPILE, fell through to\ndefault chain including deepseek-4flash-deepinfra (32K context), which\ncorrectly rejec\n[…]\nract; runtime wiring via\nnew capabilityChain option on createRegistryFromEnv in core.\n\nTarget release: alpha.29 or alpha.30 pending scope decisions.\n\nProvenance: Cross-consumer review pass 2026-07-21.",
          "is_bot": false,
          "headline": "docs(tech-debt): TD-LLMP-20 — capability-based router (declarative ta…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-07-21T23:09:19Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "f35f963f484ac7b2f87f3ae07c9eb1d4cb97187a",
          "body": "TD-LLMP-16: adapter-openai ContextWindowExceededError reports model\n\"(unknown)\" even when the model name is at request-construction time.\nReported by BEPA.\n\nTD-LLMP-17: runAgent throws raw TypeError when tools omitted; local\nTypeErrors then get misclassified as ServiceUnavailableError, triggering\nfu\n[…]\nk-table\nmisalignment) and ADW (audit finding TD-LLM-18 + policy question in\nTD-LLM-21).\n\nTarget: alpha.28 pre-work window. Each TD names its consumer-side\norigin TD so the ecosystem trail is walkable.",
          "is_bot": false,
          "headline": "docs(tech-debt): batch of 4 TDs from 2026-07-21 cross-consumer review",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-07-21T22:46:39Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "bac6ecb49ec58637d76e8f431d03225dfc7fa9df",
          "body": "7 publishable packages ship at 0.1.0-alpha.27:\n- @llm-ports/core (BREAKING: instructions/prompt removed; messages required)\n- @llm-ports/adapter-openai\n- @llm-ports/adapter-anthropic (new NonContiguousSystemError guard)\n- @llm-ports/adapter-google (new NonContiguousSystemError guard)\n- @llm-ports/ad\n[…]\npha-26-to-alpha-27.md\nDeprecation infra generalized: warnDeprecatedLegacyInput -> warnDeprecated(state, {what, where, removalVersion?, migrationUrl?})\n\n886 tests pass workspace-wide. Zero regressions.",
          "is_bot": false,
          "headline": "chore(release): v0.1.0-alpha.27",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-07-17T23:51:09Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "d3b8ad1b189cef47738a8bbceb2a3daa55e393fb",
          "body": "…es required\n\nCommits D + E bundled: the legacy fields are removed from the type\ninterfaces AND the examples migrate to the canonical messages shape.\n\nChanges in packages/core/src/ports/llm-port.ts:\n- Deleted 'instructions?: string' from GenerateTextOptions,\n  GenerateStructuredOptions, StreamTextOp\n[…]\n: 24\n\nZero regressions across the workspace.\n\nBlocker 1 + Blocker 2 + Blocker 3 all complete. Ship-ready subject to\nCommit F (migration guide + release notes + version bumps + publish\n+ BEPA Dev Log).",
          "is_bot": false,
          "headline": "feat(alpha.27): remove instructions/prompt from options + make messag…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-07-17T23:42:26Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "3d50f72d54a33b89c3490aad961a9edb416de062",
          "body": "…e migration\n\nRenames warnDeprecatedLegacyInput to warnDeprecated with a generalized\nDeprecationDetails signature. Preserves the useful primitive (WarningState +\ndedup + suppression + handler routing) for any future deprecation cycle\nwithout rebuilding it. Removes the field-specific glue that alpha.\n[…]\na.27 execution sequence. Next: Commit D (remove\nthe instructions?/prompt? fields from the four options interfaces +\nmake messages required). The rename is documented in the migration\nguide (Commit F).",
          "is_bot": false,
          "headline": "refactor(alpha.27): generalize deprecation infrastructure + test suit…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-07-17T23:21:22Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "ca0e5ba2abb4bbd665458788781dcb208ab07f12",
          "body": "Deletes populateLegacyFieldsFromMessages and simplifies the four\nRegistryPort methods (generateText, generateStructured, streamText,\nstreamStructured) to use { ...options, messages } directly, dropping\nthe legacy-field spread that alpha.26 introduced as a bridge for\nadapters that hadn't yet been upd\n[…]\n.\nThe Registry no longer touches the deprecated fields at all beyond\nthe normalizeMessagesOnOptions entry point (Commit C generalizes the\ndeprecation infra; Commit D removes the type fields entirely).",
          "is_bot": false,
          "headline": "refactor(alpha.27-prep): delete Registry dual-population code",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-07-17T23:12:23Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "89d2f98602295a4386687e5625d92bb740563b28",
          "body": "Migrates adapter-google to consume options.messages natively. Google's\nGemini API splits systemInstruction (top-level) from contents (the\nmessages array), matching Anthropic's shape. Reuses the\nNonContiguousSystemError class added in Commit A3.\n\nChanges in adapter-google/src/adapter.ts:\n- New helper\n[…]\nni)\n\nBlocker 1 complete. Next: Blocker 2 (Commit B) — delete Registry\ndual-population code (populateLegacyFieldsFromMessages + four spread\nsites). Safe now that all adapters consume messages natively.",
          "is_bot": false,
          "headline": "feat(alpha.27-prep): adapter-google native messages consumption",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-07-17T23:09:45Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "dafd979ef236624f36516a7d67b25f761b511a31",
          "body": "…sSystemError\n\nMigrates adapter-anthropic to consume options.messages natively AND\nintroduces the NonContiguousSystemError class in @llm-ports/core that\nAnthropic (and later Google) uses to reject mid-conversation system\nmessages at the adapter boundary.\n\nChanges in @llm-ports/core:\n- New NonContigu\n[…]\nlso\nlands here (rather than in a separate commit) because adapter-anthropic\nis the first user of the error class. Adapter-google (A4) reuses it.\n\nNext: A4 (adapter-google), then Commits B, C, D, E, F.",
          "is_bot": false,
          "headline": "feat(alpha.27-prep): adapter-anthropic native messages + NonContiguou…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-07-17T21:47:38Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "2fa32f0622cba17318b662e358b1f8368e833a41",
          "body": "Migrates adapter-vercel to consume options.messages natively. Vercel's\nunderlying SDK (@ai-sdk) accepts a top-level 'system' string plus a\nCoreMessage[] array; this migration extracts leading system messages\ninto the 'system' field (concatenated with \\n\\n) and passes the\nremainder as messages.\n\nChan\n[…]\nThe non-null-assertion options.messages! is intentional; becomes\nredundant in Commit D.\n\nNext: A3 (adapter-anthropic + NonContiguousSystemError class), A4\n(adapter-google), then Commits B, C, D, E, F.",
          "is_bot": false,
          "headline": "feat(alpha.27-prep): adapter-vercel native messages consumption",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-07-17T21:40:18Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "aeac34338257463933d385e0fae7aa108970701a",
          "body": "…red contract suite migration\n\nMigrates adapter-ollama to consume options.messages natively instead of\nreading options.prompt via non-null assertion (the alpha.26 shipping\nexpedient). Ollama's chat API accepts mid-conversation system messages\ninline, so the migration is the simplest of the four adap\n[…]\nevel; the ! becomes redundant but not incorrect.\n\nNext: A2 (adapter-vercel), A3 (adapter-anthropic + NonContiguousSystemError),\nA4 (adapter-google), then Blocker 2 (Registry dual-population deletion).",
          "is_bot": false,
          "headline": "feat(alpha.27-prep): adapter-ollama native messages consumption + sha…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-07-17T21:35:50Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "348c115b101bc745e1a74f2135afe9b09439f7d3",
          "body": "…al messages shape\n\nThe alpha.26 ship marked {instructions, prompt} deprecated on the port\ninterface but left @llm-ports/capabilities calling the port with the\ndeprecated shape internally. That worked at runtime (Registry dual-\npopulation synthesized messages from the legacy fields) but would have\nf\n[…]\nly the internal port call shape\nchanged.\n\nVersion: @llm-ports/capabilities@0.1.0-alpha.26.1 (hotfix; other\npackages stay on alpha.26; alpha.27 stays reserved for the coordinated\nlegacy-field removal).",
          "is_bot": false,
          "headline": "fix(alpha.26.1): migrate @llm-ports/capabilities factories to canonic…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-07-03T07:56:25Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "79cafd5e044b306cc89268ff39224131c119c18c",
          "body": "… + one-cycle deprecation\n\nBREAKING in alpha.27. This release adds the canonical shape alongside the\ndeprecated fields; alpha.27 removes the deprecated fields.\n\nThe four generation methods (generateText, generateStructured, streamText,\nstreamStructured) now accept `messages: LLMMessage[]` as the can\n[…]\n26 messages input tests; zero regressions).\n\nDocs: alpha-25-to-alpha-26 migration guide, top-level README banner\nupdated, VitePress sidebar entry.\n\nAll 7 publishable packages bumped to 0.1.0-alpha.26.",
          "is_bot": false,
          "headline": "feat(alpha.26): canonical messages input + toMessages/sys/usr helpers…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-07-02T23:16:45Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "a7498fa20f6751f9be940b2b265f5dbe8fe2a590",
          "body": "…st surfacing\n\nThree additive features under an \"Observability surface + reliability\nhardening\" theme. Zero breaking changes.\n\n**#53 refs field.** `refs?: Record<string, ArtifactRef>` on all five\ncall-options interfaces, threaded verbatim to all five observability\nevents (onCost, onTokenUsage, onFal\n[…]\nput around a\ncanonical messages: LLMMessage[] field, deprecating {instructions, prompt}\nwith a one-cycle window and a toMessages() migration shim.\n\nAll 7 publishable packages bumped to 0.1.0-alpha.25.",
          "is_bot": false,
          "headline": "feat(alpha.25): refs field + aggressive fallback preset + streamed co…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-07-02T22:42:11Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "3c33140f856f19c9036cb72fa2897f6df51220d3",
          "body": "…ree-tier architecture\n\nSame per-adapter README update pattern I missed in alpha.23's initial ship\nand had to follow up on. Catching it inline this time.\n\nAdds 'Capability detection — three-tier architecture (alpha.24+)' section\nabove the existing 'Known reasoning models' subsection. Cross-links to\nthe new docs/concepts/capability-detection.md concept page for the full\narchitectural design.\n\nIncludes the fingerprintCache option example + bundled backends overview.",
          "is_bot": false,
          "headline": "docs(alpha.24): adapter-openai README — surface fingerprintCache + th…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-06-25T02:06:57Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "8f6aa00997b0fdf9df064d2ef99a5f806a4cadea",
          "body": "…lper + Cerebras pricing\n\nThe catalog architectural redesign Babak called for across the alpha.22\n→ alpha.23 transition, plus the alpha.21-deferred onValidationRetry\nRegistry-level emission, plus Cerebras pricing entries from the 2026-06-24\nempirical reasoning-model survey.\n\n## Catalog architectural\n[…]\nache uses it)\n- parseHarmonyToolCalls (promoted from internal — alpha.23 was unexported)\n- type FingerprintCacheBackend, type ModelFingerprint\n\n@llm-ports/core:\n- deriveValidationRetryFromAdapterRetry",
          "is_bot": false,
          "headline": "feat(alpha.24): catalog architectural redesign + onValidationRetry he…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-06-25T01:56:32Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "f5d37faa6833935db0e759d6ac022eae6d6303d7",
          "body": "… telemetry tags + per-attempt timeout\n\nBeyond the migration page committed in 10fca25, four additional surfaces\nneeded alpha.23 updates that weren't in that commit:\n\npackages/adapter-openai/README.md\n  - \"Known limitation: DeepInfra gpt-oss harmony tool-use (alpha.22)\"\n    section gets an \"Update f\n[…]\nnator table mapping every reason to when-it-fires +\n    recovery-action\n  - Worked filter examples for harmony-tool-call-extracted and\n    zero-tool-call-prose-retry\n\nVerified `pnpm docs:build` clean.",
          "is_bot": false,
          "headline": "docs(alpha.23): update per-package + concept docs for ASK 1 + ASK 2 +…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-06-25T01:24:39Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "10fca258d780a94a115bc6d75ab8c69a31f47661",
          "body": "Adds docs/migration/alpha-22-to-alpha-23.md (additive-only migration note)\nand registers it in the VitePress sidebar. Covers:\n\n- Harmony tool-call extraction (automatic; closes DeepInfra gpt-oss gap)\n- Zero-tool-call corrective rescue (automatic; mimo prose case)\n- Telemetry tags via existing onRetr\n[…]\nptions.perAttemptTimeoutMs)\n- Explicit \"what's NOT fixed\" note on Case B under-production\n- Routing recommendation for orchestration-layer guards\n\nVerified with `pnpm docs:build` (clean, no warnings).",
          "is_bot": false,
          "headline": "docs(alpha.23): migration guide + sidebar entry",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-06-25T01:14:01Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "e44513ae6038ae2cbce6020f895aacbfa6769975",
          "body": "…+ per-attempt timeout\n\nFour additions, all empirically grounded in ADW's 2026-06-19 multi-team\nagentic-build-loop diagnostic + production wedge incident.\n\n## ASK 1 — Harmony tool-call extraction (adapter-openai)\n\nparseHarmonyToolCalls() extracts tool calls from harmony-formatted\nmessage.reasoning_c\n[…]\ns are additive. Existing callers see no API surface\nchanges. Two existing tests updated to accommodate ASK 2's rescue\nretry (test intent preserved; mockResolvedValue instead of\nmockResolvedValueOnce).",
          "is_bot": false,
          "headline": "feat(alpha.23): harmony tool-call extraction + zero-tool-call rescue …",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-06-25T01:10:27Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "2e4a03b4541137aa63d69f6927b2fcbc48aaa611",
          "body": "…ME + docs/adapters/openai.md\n\nBoth surfaces still showed the pre-alpha.22 framing — gpt-oss-* → Cerebras\nonly — and didn't surface what alpha.22 actually changed. Updated to\nreflect:\n\n- Three reasoning signals (added reasoning_content for DeepInfra harmony)\n- Starvation discriminator accepts finish\n[…]\nation is\nunambiguous, and includes ADW's 2026-06-19 empirical observation (Cerebras\ngpt-oss writes 5 files; DeepInfra gpt-oss writes 0 in the multi-turn\nbuild loop).\n\nVerified `pnpm docs:build` clean.",
          "is_bot": false,
          "headline": "docs(alpha.22): update reasoning-model framing in adapter-openai READ…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-06-19T16:14:50Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "89a384b33c293dde8bb6448d97ea5aff55040afc",
          "body": "Adds docs/migration/alpha-21-to-alpha-22.md (additive-only migration note)\nand registers it in the VitePress sidebar. Covers:\n\n- Model-ID normalization improvement (automatic; no caller change)\n- Runtime detection broadening for reasoning_content + finish=stop\n- Xiaomi MiMo catalog entry\n- adapter-g\n[…]\nple)\n- Explicit note on what's NOT fixed (DeepInfra gpt-oss harmony tool-use)\n- Routing recommendation: use Cerebras for gpt-oss tool-use\n\nVerified with `pnpm docs:build` (no dead links, no warnings).",
          "is_bot": false,
          "headline": "docs(alpha.22): migration guide + sidebar entry",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-06-19T16:00:37Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "41f305ec10b7beb44b4e8c76492ed4a4a44dfe5b",
          "body": "Pre-seed `MiMo-V\\d+` family as a reasoning model. Empirically driven by\nADW production incident 2026-06-19T15:40 UTC: mimo-parasail\n(XiaomiMiMo/MiMo-V2.5) starved on a structured-output decompose call.\n\nPre-this-commit, runtime detection caught the starvation (reasoning_field\nor reasoning_tokens pop\n[…]\nrefixed and canonical forms)\n- MiniMax-M2.7 still matches its own pattern (no regression)\n- Mimosa-V1 does NOT match either (negative guard)\n\n763 tests pass total (was 761 with 0a63479; +2 from MiMo).",
          "is_bot": false,
          "headline": "feat(adapter-openai): add Xiaomi MiMo to KNOWN_REASONING_MODELS catalog",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-06-19T15:54:52Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "0a634795310376c07e58f19577d07aab196c38d2",
          "body": "… httpOptions\n\nTwo themes shipped together, both empirically motivated by ADW + Dramma\nfindings on 2026-06-19.\n\n## adapter-openai: reasoning-model architecture (2 changes)\n\n### Model-ID normalization\n\nAdds normalizeModelId helper: strips a `<owner>/` namespace prefix and\nreturns the canonical name. \n[…]\n.\n\nEmpirical sources: ADW Development_Logs.md commit b1eeee2 (DeepInfra\ntool-loop root cause), Dramma 08-cloud-llm-backend-proxy-plan.md §7 Q1\n(httpOptions gap), 2026-06-19 raw 2-turn DeepInfra probe.",
          "is_bot": false,
          "headline": "feat(alpha.22): reasoning-model architecture cleanup + adapter-google…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-06-19T15:44:45Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "46285c70284fe0dd8b4278e9da6c2436fd2e1b35",
          "body": "…i adapter updates + alpha.20-to-21 migration\n\nCompanion to 094cc4d (feat(alpha.21)). The npm packages shipped without\nthe in-repo VitePress docs; this commit closes that gap.\n\nAdded:\n- docs/concepts/observability.md — full concept page for the 5 OTel-aligned\n  Registry-level hooks (onCost, onTokenU\n[…]\n — sidebar entries for the new Observability\n  concept page and the alpha.20→alpha.21 migration note.\n\nVerified: `pnpm docs:build` clean (no dead links, no warnings, all 5 new\n+ updated pages render).",
          "is_bot": false,
          "headline": "docs(alpha.21): observability hooks concept + per-call strict + opena…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-06-19T06:21:25Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "094cc4deb9d19cfbcbff61ff0bab605f550f002b",
          "body": "…ing + OTel observability hooks\n\nThree empirically-driven structured-output reliability changes plus the planned\nOTel-aligned observability hook surface.\n\n## 1. Per-call `strict?: boolean` (closes section 2 of #46)\n\n`GenerateStructuredOptions` and `StreamStructuredOptions` gain `strict?: boolean`.\nP\n[…]\n + adapter-google + adapter-ollama + adapter-vercel pass.\n\nFiled upstream: #46 (per-call strict + adapter-openai isJsonModeRejection rescue\nalready in main as 9cb9a82), #47 (allowlist), #48 (pricing).",
          "is_bot": false,
          "headline": "feat(alpha.21): per-call strict + DeepInfra/Parasail allowlist + pric…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-06-19T04:48:48Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "9cb9a82ae750afabe30a2719ec314acfc77542ea",
          "body": "…rejection (closes #46)\n\nExtends the response_format rescue trigger to also match OpenAI native's\nstrict-schema-validation rejection error pattern. The rescue downgrade\n(drop response_format, fall back to prompted JSON) is unchanged and\nalready in place; only the matcher pattern was too narrow — tun\n[…]\ntrict?: boolean` opt-out from issue #46 deferred to beta.1\nalongside the resilient-fallback preset (LP-REQ-01), where it naturally\nfits as a deliberate API addition with multi-adapter behavior matrix.",
          "is_bot": false,
          "headline": "fix(adapter-openai): isJsonModeRejection covers OpenAI strict-schema-…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-06-18T01:43:37Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "170f8e2e2fd059ce42c3d75170fd54969d65b901",
          "body": null,
          "is_bot": false,
          "headline": "fix(migrate): prefer-const on the replace() output",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-06-15T23:22:13Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "b40f49e0a1f91a7ab0a3295d9461186fe5904735",
          "body": "Implements seven mechanisms (A-G) to reduce the risk of accidental\nupgrades across breaking alphas in production code:\n\nA. docs/migration/alpha-19-to-alpha-20.md — per-release migration page\n   with the requestsPerHour type-level breakage as the lead item plus a\n   one-line fix and a codemod referen\n[…]\ngrate codemod).\n\nVersioning: 7 publishable + 1 new package (@llm-ports/migrate) all at\n0.1.0-alpha.20.1. consumer-type-check is private (no publish). Added\nboth to .changeset/pre.json initialVersions.",
          "is_bot": false,
          "headline": "feat(alpha.20.1): migration safeguards across docs, install, and tooling",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-06-15T23:19:36Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "66275f11a4feacb08959da428b569202b09b048b",
          "body": "The fourth alpha shape-lock before beta.0. Additive only — no breaking\nchanges vs alpha.19.1. Backwards compatible: existing callers and env\nconfigs see identical behavior.\n\nNew types in @llm-ports/core:\n- BudgetScope = \"tenant\" | \"customer\" | \"user\" | \"agent\" | \"session\"\n- BudgetScopeRef = { scope:\n[…]\nns enforced via CostSession\n\nTest stats: 678 across 7 packages (was 654 in alpha.19.1; +24 new).\n\nVersioning: manual bump to 0.1.0-alpha.20 to preserve the planned\nalpha sequence (.20 → .21 → beta.0).",
          "is_bot": false,
          "headline": "feat(alpha.20): BudgetScope + minute/session gating grammar",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-06-13T20:36:37Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "2f13c318f06c622d11b00fb680ce75c0c1096b39",
          "body": "Closes the gaps Babak flagged after alpha.19.1 published:\n\n- docs/guides/cost-gating.md, docs/migration/from-direct-sdk.md: rename\n  stale cost.cacheDiscountUSD references to cost.cacheSavingsUSD (the\n  alpha.18 → alpha.19 field rename had not propagated to these pages).\n- docs/migration/alpha-18-to\n[…]\nrom navigation); Migration\n  sidebar now links the alpha.18 → alpha.19 BREAKING-tagged entry.\n\nVitePress build verified clean (6.62s). Docs-only commit: no version\nbump, no republish, no test changes.",
          "is_bot": false,
          "headline": "docs: alpha.19.1 follow-up cleanup across the docs site",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-06-13T02:42:58Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "0b3cb4792f1a3043e015aff24337ecabee059aa4",
          "body": "…ility factories\n\nThe shape committed in alpha.19 is now backed by verified per-mode behavior\non the cloud adapters and pass-through on every capability factory. Closes\nthe gap between alpha.19's locked surface and the docs that prematurely\ndescribed per-mode adapter behaviors in present tense.\n\nada\n[…]\netScope) →\nalpha.21 (observability hooks) → beta.0 sequence. changeset pre-mode\nwould have rolled to alpha.20 by default; this fixes a real gap in\nalpha.19 rather than expanding into alpha.20's scope.",
          "is_bot": false,
          "headline": "feat(alpha.19.1): CacheControl behavior across cloud adapters + capab…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-06-12T22:55:59Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "3aadfff56c88970f698d7272300dde2bb8005cbc",
          "body": "Used as the cover image for the alpha.19 dev.to ship article and as\nthe image attachment for the X (Twitter) thread on the alpha.19\nrelease. Lives at assets/ so its raw GitHub URL is stable:\n  https://raw.githubusercontent.com/baabakk/llm-ports/main/assets/llm-ports.png",
          "is_bot": false,
          "headline": "chore(assets): add llm-ports.png for social cards + dev.to cover",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-06-12T20:01:41Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "02556479853fb4d09821fe4422f32edb0e9fa275",
          "body": "7 publishable packages bumped to 0.1.0-alpha.19:\n- @llm-ports/core (minor; new CacheControl public type + cacheSavingsUSD rename)\n- @llm-ports/adapter-openai, -anthropic, -google, -ollama, -vercel (patch)\n- @llm-ports/capabilities (patch)\n\n10 example workspace projects bumped along for the ride.\n\nGenerated by `pnpm changeset version` from .changeset/alpha-19-*.md.",
          "is_bot": false,
          "headline": "release(alpha.19): version + CHANGELOG bumps",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-06-12T19:19:15Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "c0ef1d72d96fcef7cc7f1a91484755f6461f651f",
          "body": "…AKING)\n\nLocks the CacheControl shape so beta.0 ships the right abstraction over\nthe three caching patterns the major providers expose (Anthropic explicit\ncache_control markers, OpenAI implicit always-on cache, Google Gemini\ncreateCachedContent handle). Renames cost.cacheDiscountUSD to\ncost.cacheSav\n[…]\n- New: docs/concepts/cache.md (locked shape + per-provider behavior table).\n- New: docs/migration/alpha-18-to-alpha-19.md (step-by-step migration).\n- Updated: docs/v0-1-status.md (alpha.19 row added).",
          "is_bot": false,
          "headline": "feat(alpha.19): CacheControl shape lock + cacheSavingsUSD rename (BRE…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-06-12T19:17:58Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "0c124c392172dc99b8cee3e56418586a68dddb42",
          "body": "Auto-generated by changeset version. 7 published packages bumped to\n0.1.0-alpha.18; example workspaces + adapter-contract-tests + benchmarks\nbumped via @llm-ports/* linked-group.",
          "is_bot": false,
          "headline": "release(alpha.18): version + CHANGELOG bumps",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-06-05T09:13:28Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "79e0dd9eeed2dda0df0d0bdf349a9b07cf1f8b0a",
          "body": "Largest single correctness fix in the v0.1 line. Closes the architectural\nbug where a 400 context-window overflow got wrapped as\nProviderUnavailableError, causing the registry to fall back to another\nprovider that would fail the same way.\n\nNEW classes in @llm-ports/core/src/errors.ts:\n- LLMPortError\n[…]\nkspace (up from 577 in alpha.17). 29\nnew error-taxonomy tests + 5 ollama onRetry + 4 google onRetry. Several\nalpha.17-era adapter-openai tests updated to assert the new typed\nclasses (4 quirks files).",
          "is_bot": false,
          "headline": "feat(alpha.18): typed-error taxonomy + alpha.17 closeout (BREAKING)",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-06-05T09:13:17Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "210920c393c2b5592cd98194805c312bede91b38",
          "body": "…missing disables)\n\nPre-existing lint errors that the CI surfaced when alpha.17 pushed. All\n4 are mechanical eslint-disable fixes; no behavior change.\n\n- adapter-anthropic/src/adapter.ts:67: typescript-eslint renamed\n  no-require-imports -> no-var-requires; add both disable names so the\n  comment su\n[…]\n the\n  intentional 'const session = this' alias used inside the getPort()\n  closure (no-this-alias).\n\n577 tests still passing; lint now clean (3 pre-existing unused-var\nwarnings remain; not blocking).",
          "is_bot": false,
          "headline": "fix(lint): unblock CI on alpha.17 push (4 errors from rule renames + …",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-06-05T08:01:50Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "ecd13f4692699d1cd2f909d7a7a33d6ac50ecdb0",
          "body": "Auto-generated by changeset version. 7 published packages bumped to\n0.1.0-alpha.17; example workspaces and adapter-contract-tests +\nbenchmarks bumped in lockstep via the @llm-ports/* linked-group.",
          "is_bot": false,
          "headline": "release(alpha.17): version + CHANGELOG bumps",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-06-05T07:17:56Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "4087d6f309f36ffdb28c65cc202379ac296e6a3a",
          "body": "First alpha of the v0.1 line approved by Babak per the BEPA-internal\nRELEASE-PLAN-0.1.0-roadmap-to-1.0.md.\n\nFive additive items + RerankPort skeleton (no breaking changes):\n\n- @llm-ports/core: new RerankPort interface in src/ports/rerank-port.ts.\n  Sibling of LLMPort and EmbeddingsPort. Modeling rer\n[…]\nest.ts\nat lines 163 and 192. No code change; the master plan item is closed by\nverifying the existing tests pin the property.\n\nWorkspace tests: 577 passing (up from 567 in alpha.16). Zero regressions.",
          "is_bot": false,
          "headline": "feat(alpha.17): RerankPort skeleton + jittered backoff + onRetry parity",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-06-05T07:17:45Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "1c5f8b22435f00bb6749a3159b7c32825adfbe90",
          "body": "Auto-generated by changeset version. 7 published packages bumped to\n0.1.0-alpha.16; example workspaces and internal-only packages\n(adapter-contract-tests, benchmarks) bumped in lockstep via the\n@llm-ports/* linked-group config.",
          "is_bot": false,
          "headline": "release(alpha.16): version + changelog bumps for providerExtras",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-05-30T20:37:16Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "df2b83802dfc81d7e4510724034b9dff55cfb75f",
          "body": "Add providerExtras?: Record<string, unknown> to all 5 *Options interfaces.\nPer-call escape hatch for provider-specific request fields the port does\nnot model. Shallow-merged into the SDK request body AFTER typed port\nfields, so callers can override typed defaults.\n\nThreaded through:\n- All 5 LLMPort \n[…]\n { vllm: {...} }) so the public type signature does\nnot endorse any one OSS-serving runtime.\n\n15 new tests (6 adapter-openai quirks + 9 capability passthrough);\n567 tests passing across the workspace.",
          "is_bot": false,
          "headline": "feat(alpha.16): providerExtras escape hatch for vLLM + SGLang",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-05-30T20:37:06Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "2d17a4c3965b793b9fae52ea0bd0c2f7b85948da",
          "body": null,
          "is_bot": false,
          "headline": "chore(release): bump @llm-ports/adapter-openai to 0.1.0-alpha.15",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-05-27T08:14:30Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "e1cd8c5ad34899aeeb50d8e0ca86c3f767dfc9f8",
          "body": "…ambaNova\n\nEmpirically verified 2026-05-27 — BEPA A/B harness forced\nuseStrictResponseFormat: true on a SambaNova adapter and MiniMax-M2.7\nwent from 0/10 → 10/10 schema-valid on a nested production scoring\nschema. 3987ms avg, $0.041/10-calls. SambaNova accepts strict\nresponse_format: json_schema and\n[…]\nether AI as the new unknown-compat exemplar. 144\nadapter-openai tests passing.\n\nSub-task 2 (Anthropic structured-output discipline via tool-use-with-\ninput_schema) is structural library work for v0.2.",
          "is_bot": false,
          "headline": "feat(adapter-openai): expand useStrictResponseFormat auto-detect to S…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-05-27T08:13:56Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "fa3d28b3ff2510ff25fa1818ad010a72e414c9a5",
          "body": null,
          "is_bot": false,
          "headline": "chore(release): bump @llm-ports/adapter-openai to 0.1.0-alpha.14",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-05-27T04:14:30Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "da17ec87e4fd08e47bc5d9335d631debde639cb0",
          "body": "…penAI native + Groq\n\nBehavior change: generateStructured against OpenAI native (no baseURL)\nor Groq (api.groq.com) now uses strict response_format: json_schema by\ndefault. Cerebras was the only auto-detect target in alpha.9; everyone\nelse silently paid the un-strict retry-with-feedback tax.\n\nEviden\n[…]\n\nExports autoDetectStrictResponseFormat helper.\n\n15 new tests; 143 adapter-openai / 552 workspace passing.\n\nDiscovered by BEPA Upwork-scoring A/B harness (Development_Logs.md\n2026-05-26T20:45 -07:00).",
          "is_bot": false,
          "headline": "feat(adapter-openai): expand useStrictResponseFormat auto-detect to O…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-05-27T04:13:19Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "14fcb6cf462ffe7556e42e4cc055ad0e56f4ed79",
          "body": "…y passthrough + repair extensions\n\n- README.md: bump pointer to alpha.13; closed-issues paragraph expanded\n  to cover alpha.10/11/12/13 (Claude 4.5+ catalog, generateStructured\n  usage accumulation, reasoningEffort passthrough, capability factory\n  port-surface alignment).\n- docs/v0-1-status.md: st\n[…]\nncy trade-off table, when NOT\n  to use it.\n- docs/.vitepress/config.ts: wire new reasoning-effort guide into the\n  Guides sidebar.\n\nLocal pnpm docs:build clean. deploy-docs workflow will fire on push.",
          "is_bot": false,
          "headline": "docs(site): alpha.12 + alpha.13 surface — reasoningEffort + capabilit…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-05-27T03:24:33Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "8002fa4230459f1bc7164bf3be5a24bd876d9d9d",
          "body": null,
          "is_bot": false,
          "headline": "chore(release): bump packages to 0.1.0-alpha.13",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-05-27T03:11:43Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "7c27b2d1624b6128aa30c7e370e1edf28700feff",
          "body": "…viderAlias + extend repair\n\nAll 7 capability factories now thread the missing port options through to\nthe underlying call:\n- reasoningEffort: per-factory, on Create*Config\n- signal: per-call, on *Input\n- forceProviderAlias: per-call, on *Input\n\nCloses BEPA TD-LLMPORTS-CAPABILITIES-REASONING-EFFORT \n[…]\ny into the expected shape.\n- Pattern 8 (new): single-element array unwrap when object expected.\n\n29 repair tests (was 18) + 13 capability passthrough tests. 537 tests\npassing workspace-wide (was 508).",
          "is_bot": false,
          "headline": "feat(capabilities,core): pass-through reasoningEffort/signal/forcePro…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-05-27T03:10:29Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "0b38d0f75e5c598120217a981d6d5e083b27938f",
          "body": null,
          "is_bot": false,
          "headline": "chore(release): bump packages to 0.1.0-alpha.12",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-05-27T02:02:54Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "1d7842604ae41278130c87645ee5f2ee754b325b",
          "body": "Adds reasoningEffort?: \"low\" | \"medium\" | \"high\" to all 5 LLMPort *Options\ninterfaces. adapter-openai forwards it as reasoning_effort on the SDK call.\n\nCloses BEPA-side TD-LLMPORTS-REASONING-EFFORT: Groq's openai/gpt-oss-120b\ncontrols reasoning depth via this parameter (no separate model IDs per\neff\n[…]\n a non-reasoning model rejects the\nfield) is v0.2 scope.\n\n5 new tests covering all 4 call shapes (generateText / generateStructured /\nrunAgent / triple-effort-level). 508 tests passing workspace-wide.",
          "is_bot": false,
          "headline": "feat(core,adapter-openai): add reasoningEffort to *Options",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-05-27T02:01:53Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "4f9d75b7a7205d1f791b0cc780c1e476edb1a716",
          "body": null,
          "is_bot": false,
          "headline": "chore(release): bump 5 adapter packages to 0.1.0-alpha.11",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-05-26T11:25:48Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "c4e18250b5a0f4f8d554de5afda8f790341918f4",
          "body": "…h-feedback\n\nBug: lastUsage = parseUsage(response) OVERWROTE the usage tracker on each\nretry-with-feedback iteration. validationAttempts correctly reported 2,\nbut result.usage / result.cost only reflected the 2nd SDK call. Cost\naccounting under-reported by exactly the first attempt's cost.\n\nFix: las\n[…]\neen correct.\n\nReported by user 2026-05-26: claude-haiku-4-5 retry was returning\nvalidationAttempts: 2 but ~832 total tokens (single-call-shaped) — the\nmetric was right, the usage field wasn't summing.",
          "is_bot": false,
          "headline": "fix(adapter-*): generateStructured accumulates usage across retry-wit…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-05-26T11:24:33Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "f176b5f391d58e8bdc578360cdd574a1429584bd",
          "body": null,
          "is_bot": false,
          "headline": "chore(ci): re-trigger docs deploy after GitHub dispatch 500",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-05-26T11:07:09Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "0cd5666b69f6a21158107f5524c6a4745895b567",
          "body": "… strict-JSON, listModels, opus-4-7\n\n- README.md: bump version pointer to alpha.9 (all 7 packages); add #9 / #32\n  to closed-issues list; trim \"still open\" entries for what just shipped.\n- docs/v0-1-status.md: add listModels + checkPricingFreshness + strict-JSON +\n  browser-flag rows to \"stable\" tab\n[…]\n why we don't auto-update bundled tables.\n- docs/.vitepress/config.ts: wire the new model-discovery guide into the\n  Guides sidebar.\n\nBuild verified locally; deploy-docs workflow will trigger on push.",
          "is_bot": false,
          "headline": "docs(site): alpha.9 + alpha.10 surface — Gemini parity, browser flag,…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-05-26T11:00:31Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "eadc2bc7bc0638ecba26b8a32decb55a5b8e26ea",
          "body": null,
          "is_bot": false,
          "headline": "chore(release): bump @llm-ports/adapter-anthropic to 0.1.0-alpha.10",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-05-26T10:53:22Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "a239d8c224772e000058681ef2b83c17ed4e33fc",
          "body": "…d family\n\nSymptom: streamText against claude-opus-4-7 hard-failed with 400\n\"temperature is deprecated for this model.\" because the static catalog\nonly covered 4-5. Non-streaming methods auto-recovered via the in-adapter\ncapability-fallback retry, but streaming methods can't mid-stream retry.\n\nFix:\n\n[…]\nionAttempts to lock in the\n1-on-first-success / 2-on-retry semantics (filed after a user observation\nthat conflated the field with the strict-mode-fixes-Cerebras issue;\nverified the field is correct).",
          "is_bot": false,
          "headline": "fix(adapter-anthropic): seed temperatureLocked for claude-opus-4-7 an…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-05-26T10:52:08Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "aede17c0a50ca3df2a5d6f0000759be38571906a",
          "body": "- @llm-ports/core: minor (listModels, ProviderModelInfo, Registry.checkPricingFreshness)\n- @llm-ports/capabilities: patch (re-exports)\n- @llm-ports/adapter-openai: minor (useStrictResponseFormat for Cerebras), patch (dangerouslyAllowBrowser, listModels)\n- @llm-ports/adapter-anthropic: patch (dangero\n[…]\n- @llm-ports/adapter-google: minor (multi-turn runAgent, native responseSchema, listModels)\n- @llm-ports/adapter-ollama: minor (listModels)\n- @llm-ports/adapter-vercel: patch (README browser-flag doc)",
          "is_bot": false,
          "headline": "chore(release): bump 7 packages to 0.1.0-alpha.9",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-05-26T10:29:24Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "d3e52789cb2edd98a5ddf7e8de3a424e354261ba",
          "body": null,
          "is_bot": false,
          "headline": "Merge alpha.9 bundle",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-05-26T10:26:50Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "286f1325af5c2fd88d9aaee345d6cccda8a17aca",
          "body": "…trict JSON\n\nCloses #9 (listModels half), #32 (dangerouslyAllowBrowser).\n\nadapter-google:\n- runAgent now multi-turn via Gemini function-calling loop. Translates\n  tools to Gemini's Tool[] shape (zod-to-json-schema, OpenAPI 3.0\n  subset), loops chat/function-call/function-response until model\n  retur\n[…]\normat = 8\n- adapter-anthropic: 2 browser-flag\n- adapter-google: 7 multi-turn runAgent + 6 native responseSchema = 13\n- core: 4 checkPricingFreshness\n\n486 tests total across the workspace; all passing.",
          "is_bot": false,
          "headline": "feat(alpha-9): Gemini parity + listModels + browser flag + Cerebras s…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-05-26T10:26:36Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "b54230d6726cb178989b4730ab7a037f8791c0de",
          "body": null,
          "is_bot": false,
          "headline": "docs(README): bump pointer to alpha.8 (5 adapter packages)",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-05-26T06:46:24Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "32b1397065fb9c382b8191db502d2d7b12889e96",
          "body": "…bilities unchanged)",
          "is_bot": false,
          "headline": "chore(release): bump 5 adapter packages to 0.1.0-alpha.8 (core + capa…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-05-26T06:44:34Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "6b6f139a9d795f757673ae0c3c27c680d7fbb2b3",
          "body": "Closes #7 (per-adapter README harmonization), #8 (.env.example per example),\nplus three v0.1-status gaps that didn't have GH issues (Vercel multi-turn\nrunAgent, full multimodal, bundled pricing).\n\nVercel adapter (the big one):\n- runAgent: replaces single-turn shim with Vercel native tools + maxSteps\n[…]\n env\n  vars that example actually references.\n\n459 tests passing across 7 packages (no change — alpha.8's work is\nintegration-test surface + docs, not unit-test material).\n\nBranch: feat/alpha-8-bundle",
          "is_bot": false,
          "headline": "feat(alpha-8): Vercel parity + compat-provider live tests + doc polish",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-05-26T06:43:21Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "fb7ffd8b7b59f6b0ffc48157a15da24b95831d9e",
          "body": "… flip",
          "is_bot": false,
          "headline": "docs(README): bump pointer to 0.1.0-alpha.7 + runtime-fallback status…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-05-23T22:49:40Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "aefda09b5999ec647062312a09543d3f0a53de94",
          "body": null,
          "is_bot": false,
          "headline": "chore(release): bump packages to 0.1.0-alpha.7",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-05-23T22:47:07Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "c8051691e98216a9c38d069e17fc068f166330d4",
          "body": "…de 20 prep\n\nCloses #9 (registry runtime fallback), #15 (forceProviderAlias), #26 (Node 20 deprecation prep).\n\nRegistry runtime fallback:\n- New RegistryOptions.runtimeFallback: \"default\" | \"none\" | { shouldFallback }\n- Default walks on ProviderUnavailableError; \"none\" preserves v0.1 behavior\n- selec\n[…]\nk + 5 forceProviderAlias).\nThe registry-edges TD-LLMP-09 test (documented OLD behavior) was inverted to\nassert the new alpha.7 behavior.\n\n459 tests passing across 7 packages.\nPublic API additive only.",
          "is_bot": false,
          "headline": "feat(alpha-7): registry runtime fallback + forceProviderAlias + CI No…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-05-23T22:45:50Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "d49a85233b1c857096af6f47dd01fd0bce65fe7a",
          "body": "…debar wiring, v0-1-status refresh\n\nNew pages:\n- docs/adapters/google.md — Gemini adapter (shipped alpha.5, no doc page until now). Covers\n  install, configure, pricing, feature matrix, why-this-vs-OpenAI-compat-baseURL, and\n  alpha.6 cancellation behavior.\n- docs/guides/cancellation.md — AbortSigna\n[…]\nalled out; Gemini\n  v0.2 scope items listed.\n- v0.3+ section: adapter-google moved out (now stable); browser-native local-model\n  adapter (#13) called out as the highest-impact remaining roadmap item.",
          "is_bot": false,
          "headline": "docs: alpha.5 + alpha.6 — Gemini adapter page, cancellation guide, si…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-05-23T11:29:23Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "3e44c4161ed263ef7ecd0586eb275d9aeb7cc5d7",
          "body": null,
          "is_bot": false,
          "headline": "docs(README): bump pointer to 0.1.0-alpha.6 (AbortSignal regression fix)",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-05-23T11:15:01Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "881c8f2147bd7d52414a8ac443df02c58ff9ada1",
          "body": null,
          "is_bot": false,
          "headline": "chore(release): bump packages to 0.1.0-alpha.6",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-05-23T11:13:09Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "34cd6cd19d7391ef50fbb42db0cfc34ad6b3b8af",
          "body": "…ch adapter's fetch\n\nCloses #24. Restores mid-flight cancellation that was missing in alpha.5.\n\nCore changes:\n- GenerateTextOptions, GenerateStructuredOptions, StreamTextOptions,\n  StreamStructuredOptions, RunAgentOptions all gain `signal?: AbortSignal`\n- New @llm-ports/core export `throwIfAborted(s\n[…]\n verified (everyone else)\n\n21 new tests (6 unit in core/abort.test.ts + 3 contract tests x 5 adapters).\nPublic API additive only. 446 tests passing across 7 packages.\n\nBranch: fix/abort-signal-options",
          "is_bot": false,
          "headline": "fix(alpha-6): thread signal?: AbortSignal through all 5 *Options + ea…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-05-23T11:11:43Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "278fa48901a4d567dd4f4a8011533a2f5383d4fd",
          "body": "…dapter + validation hardening + session cost gate",
          "is_bot": false,
          "headline": "docs(README): alpha.5 — 7 packages, 11 closed issues, native Gemini a…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-05-21T04:28:10Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "b3abe594e07e42e7b2e0ab486e8a20d8297cdbbc",
          "body": "Consumes 4 changesets:\n- validation-hardening (minor core + 4 adapter patches)\n- image-boundary-validation (minor across core + 4 adapters)\n- session-cost-gate (minor core)\n- adapter-google (minor — new package)\n\nAll packages now 0.1.0-alpha.5. 425 tests passing across 7 packages.",
          "is_bot": false,
          "headline": "chore(release): bump packages to 0.1.0-alpha.5",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-05-21T04:24:47Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "b00ff6589d5d8ed9bd9aae6859f727d85f87ff77",
          "body": "… cost gate + Gemini adapter\n\nFive-piece bundle for alpha.5:\n\n1. Validation hardening (core + 4 adapters)\n   - extractJSON falls back to jsonrepair when JSON.parse fails, gated on\n     \"input contains { or [\". Catches trailing commas, single quotes,\n     smart quotes, unquoted keys, Python literals,\n[…]\nupport for the\n     new adapter (Gemini: base64+url)\n\nTotal: 425 tests across 7 packages (was 345 across 6 in alpha.4, +80).\nAll typecheck clean. Public API additive only.\n\nBranch: feat/alpha-5-bundle",
          "is_bot": false,
          "headline": "feat(alpha-5): validation hardening + image boundary checks + session…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-05-21T04:23:18Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "9fa34d1bae8f1d66a2a9e57a04e9b7b2c97c8d8b",
          "body": "…tail\n\n- Version pointer 0.1.0-alpha.3 -> 0.1.0-alpha.4\n- Adds alpha.4 highlight: ImageSource.detail field for OpenAI vision\n  cost control + image conformance test in the contract suite\n\nNo behavior change.",
          "is_bot": false,
          "headline": "docs(README): bump pointer to 0.1.0-alpha.4 + announce ImageSource.de…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-05-21T02:53:29Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "d4d1273fec4ca36c74217f3fce272bc75edbe9ad",
          "body": "Consumes 2 pending changesets from image-pipeline hardening:\n- image-detail-field (minor: core + adapter-openai) — new\n  ImageSource.detail field for OpenAI vision cost control\n- image-contract-test (patch: anthropic, openai, ollama, vercel) —\n  new imageContentSupport declaration in contract tests\n\nAll packages bumped to 0.1.0-alpha.4. Public API additive only.\n345 tests passing.",
          "is_bot": false,
          "headline": "chore(release): bump packages to 0.1.0-alpha.4",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-05-21T02:50:47Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "004620ad6663c6fc9249fc934bc6e795b8083a19",
          "body": "Registry converts LLM_PROVIDER_VISION_ANTHROPIC env var to alias\n\"vision-anthropic\" (lowercase + underscores-to-hyphens). The script was\nreferencing the alias with underscores in task-route values and\ngenerateText taskType. Now matches the framework convention.\n\nVerified against real OpenAI gpt-4o-mini (base64 PNG with detail=\"low\"\n+ URL PNG with detail=\"auto\"). Both paths reached the model and got a\nresponse. Anthropic path hit a 400 credit-balance error (out of band;\nnot a wire-format issue).",
          "is_bot": false,
          "headline": "fix(live-vision): use kebab-case for provider + task aliases",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-05-21T02:49:33Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "f0885e64d40f2e6bb5d3183a14831cd2186c9673",
          "body": "…contract tests + live test\n\nThree related changes closing audit gaps surfaced by the image-pipeline\nreview:\n\n1. ImageSource gains optional `detail?: \"auto\" | \"low\" | \"high\"`.\n   Forwarded to OpenAI's image_url.detail. Lets vision-heavy workloads\n   choose between ~85 tokens/image (detail=\"low\" for \n[…]\ner-contract-tests: minor (new test surface)\n- @llm-ports/adapter-anthropic, -ollama, -vercel: patch (imageContentSupport flag)\n\n345 tests passing (+11 over alpha.3 baseline). Public API additive only.",
          "is_bot": false,
          "headline": "feat(core,adapter-openai): image-pipeline hardening — detail field + …",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-05-21T01:57:52Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "2bda447d32bb4ce1e3213152c564f32f290f763f",
          "body": "…lpha.3\n\n- \"Five medium-impact\" -> \"Six\": #12 closed, alpha.3 shipped\n- Note hoisted core utilities + KNOWN_REASONING_MODELS catalog\n- Drop the per-package \"alpha.2 vs alpha.1\" version chase; all packages\n  now at 0.1.0-alpha.3\n\nNo behavior change.",
          "is_bot": false,
          "headline": "docs(README): update alpha-bake summary + version pointer for 0.1.0-a…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-05-21T01:17:10Z",
          "body_truncated": false,
          "is_coding_agent": false
        },
        {
          "oid": "f1699105d7b1237045e3c34b4666ab525d2397e2",
          "body": "Consumes 6 pending changesets:\n- core-shared-utilities (minor) — 5 shared adapter utilities + retry-emit\n  + capability-learning + notify-learning hoisted to @llm-ports/core\n- adapter-anthropic-temperature-fix (minor) — closes #12; strips\n  temperature on Claude 4.5+ reasoning models with runtime le\n[…]\ntils (patch) — consume core utilities\n\nAll packages bumped to 0.1.0-alpha.3. Public API unchanged for the patch\nbumps; core + adapter-anthropic gain new exported surface (additive).\n334 tests passing.",
          "is_bot": false,
          "headline": "chore(release): bump packages to 0.1.0-alpha.3",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-05-21T00:38:41Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "61b27a02007505b57301101423657c7763ff5103",
          "body": "The KNOWN_REASONING_MODELS catalog adds two new compat providers worth\nnaming on the top-level visibility surfaces. Adoption funnel was:\n\n- Top-level README.md: previously listed \"Cerebras via OpenAI baseURL,\n  Groq, Together AI, Fireworks\" as providers needing pricingOverrides.\n  Now also names Cla\n[…]\ned)\" section listing the catalog patterns with provider\n  examples; bundled-pricing-coverage note clarifies that compat-provider\n  models require pricingOverrides.\n\nNo behavior change; no test impact.",
          "is_bot": false,
          "headline": "docs: surface Clarifai + SambaNova on home page + npm READMEs",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-05-21T00:14:02Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "371e1c8830888b1877f9043bc66a0c6800a2f71d",
          "body": "…iniMax-M2.7\n\nReplace placeholder $0/$0 pricing in worked-example configs with the live\npublic numbers:\n\n- Clarifai (FP8) — Qwen3.6 35B A3B FP8: $0.76 in / $0.43 out per 1M;\n  blended ~$0.72/1M; 262k context. Output cheaper than input is unusual;\n  it's an FP8 quantization economics quirk, not a doc\n[…]\n/quirks/known-reasoning-models.test.ts:\n  test pricingOverrides now use the real numbers (still mocks the SDK,\n  so no live cost incurred).\n- .changeset: pricing breakdown added to the changeset body.",
          "is_bot": false,
          "headline": "docs(adapter-openai): real pricing for Clarifai Qwen3.6 + SambaNova M…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-05-20T23:30:36Z",
          "body_truncated": true,
          "is_coding_agent": false
        },
        {
          "oid": "e5d058fc5495e9d72b8f919b695ab115011a237f",
          "body": "…6 + SambaNova MiniMax-M2.7)\n\nPre-seeds the capability learner at port creation so first calls against\nknown reasoning models skip the starvation-retry round-trip.\n\nCatalog covers:\n- OpenAI o-series (o1*, o3*, o4*)\n- OpenAI gpt-5-nano*\n- Cerebras gpt-oss-* (via baseURL=https://api.cerebras.ai/v1)\n- \n[…]\nModels with reasoning\" entry listing\n  catalog patterns + first-seen release.\n\nExports added: KNOWN_REASONING_MODELS from @llm-ports/adapter-openai.\nPublic API otherwise unchanged. All 334 tests pass.",
          "is_bot": false,
          "headline": "feat(adapter-openai): KNOWN_REASONING_MODELS catalog (Clarifai Qwen3.…",
          "author_name": "baabakk",
          "author_login": "baabakk",
          "committed_at": "2026-05-20T23:28:10Z",
          "body_truncated": true,
          "is_coding_agent": false
        }
      ],
      "releases_count": 82,
      "commits_last_year": 165,
      "latest_release_at": "2026-07-17T23:55:25Z",
      "latest_release_tag": "@llm-ports/core@0.1.0-alpha.27",
      "releases_from_tags": false,
      "days_since_last_push": 9,
      "active_weeks_last_year": 12,
      "days_since_latest_release": 13,
      "mean_days_between_releases": 3.8
    },
    "community": {
      "has_readme": true,
      "has_license": true,
      "has_description": true,
      "has_contributing": true,
      "health_percentage": 100,
      "has_issue_template": false,
      "has_code_of_conduct": true,
      "has_pull_request_template": true
    },
    "ecosystem": {
      "packages": [
        {
          "name": "@llm-ports/core",
          "exists": true,
          "license": "MIT",
          "keywords": [
            "llm",
            "ai",
            "typescript",
            "openai",
            "anthropic",
            "ollama",
            "ai-sdk",
            "generative-ai",
            "llm-routing",
            "llm-fallback",
            "llm-abstraction",
            "multi-provider",
            "multi-provider-llm",
            "ports-and-adapters",
            "hexagonal-architecture",
            "cost-control",
            "cost-gating",
            "vendor-lock-in",
            "provider-router",
            "ai-architecture",
            "production-llm"
          ],
          "ecosystem": "npm",
          "matches_repo": true,
          "registry_url": "https://www.npmjs.com/package/@llm-ports/core",
          "is_deprecated": false,
          "latest_version": "0.1.0-alpha.28",
          "repository_url": "https://github.com/baabakk/llm-ports",
          "versions_count": 24,
          "total_downloads": null,
          "dependents_count": null,
          "deprecation_note": null,
          "maintainers_count": 1,
          "monthly_downloads": 1825,
          "first_published_at": "2026-05-12T02:22:27.130000Z",
          "latest_published_at": "2026-07-22T12:51:43.497000Z",
          "latest_version_yanked": null,
          "days_since_latest_publish": 9
        },
        {
          "name": "@llm-ports/migrate",
          "exists": true,
          "license": "MIT",
          "keywords": [
            "llm-ports",
            "migrate",
            "codemod",
            "alpha"
          ],
          "ecosystem": "npm",
          "matches_repo": true,
          "registry_url": "https://www.npmjs.com/package/@llm-ports/migrate",
          "is_deprecated": false,
          "latest_version": "0.1.0-alpha.20.1",
          "repository_url": "https://github.com/baabakk/llm-ports",
          "versions_count": 1,
          "total_downloads": null,
          "dependents_count": null,
          "deprecation_note": null,
          "maintainers_count": 1,
          "monthly_downloads": 38,
          "first_published_at": "2026-06-15T23:25:02.835000Z",
          "latest_published_at": "2026-06-15T23:25:03.126000Z",
          "latest_version_yanked": null,
          "days_since_latest_publish": 45
        },
        {
          "name": "@llm-ports/capabilities",
          "exists": true,
          "license": "MIT",
          "keywords": [
            "llm",
            "ai",
            "typescript",
            "generative-ai",
            "llm-ports",
            "llm-capabilities",
            "capabilities",
            "classify",
            "score",
            "draft",
            "summarize",
            "extract",
            "plan",
            "analyze",
            "structured-output",
            "zod",
            "json-mode",
            "factory-pattern",
            "reusable-prompts",
            "production-llm"
          ],
          "ecosystem": "npm",
          "matches_repo": true,
          "registry_url": "https://www.npmjs.com/package/@llm-ports/capabilities",
          "is_deprecated": false,
          "latest_version": "0.1.0-alpha.28",
          "repository_url": "https://github.com/baabakk/llm-ports",
          "versions_count": 25,
          "total_downloads": null,
          "dependents_count": null,
          "deprecation_note": null,
          "maintainers_count": 1,
          "monthly_downloads": 1387,
          "first_published_at": "2026-05-12T02:22:26.644000Z",
          "latest_published_at": "2026-07-22T12:51:43.185000Z",
          "latest_version_yanked": null,
          "days_since_latest_publish": 9
        },
        {
          "name": "@llm-ports/adapter-aider",
          "exists": true,
          "license": "MIT",
          "keywords": [
            "llm-ports",
            "aider",
            "adapter",
            "subprocess",
            "agent"
          ],
          "ecosystem": "npm",
          "matches_repo": true,
          "registry_url": "https://www.npmjs.com/package/@llm-ports/adapter-aider",
          "is_deprecated": false,
          "latest_version": "0.1.0-alpha.28",
          "repository_url": "https://github.com/baabakk/llm-ports",
          "versions_count": 1,
          "total_downloads": null,
          "dependents_count": null,
          "deprecation_note": null,
          "maintainers_count": 1,
          "monthly_downloads": 65,
          "first_published_at": "2026-07-22T12:51:43.073000Z",
          "latest_published_at": "2026-07-22T12:51:43.356000Z",
          "latest_version_yanked": null,
          "days_since_latest_publish": 9
        },
        {
          "name": "@llm-ports/adapter-codex",
          "exists": true,
          "license": "MIT",
          "keywords": [
            "llm",
            "ai",
            "codex",
            "openai",
            "agent",
            "subprocess",
            "llm-ports",
            "adapter"
          ],
          "ecosystem": "npm",
          "matches_repo": true,
          "registry_url": "https://www.npmjs.com/package/@llm-ports/adapter-codex",
          "is_deprecated": false,
          "latest_version": "0.1.0-alpha.28",
          "repository_url": "https://github.com/baabakk/llm-ports",
          "versions_count": 1,
          "total_downloads": null,
          "dependents_count": null,
          "deprecation_note": null,
          "maintainers_count": 1,
          "monthly_downloads": 63,
          "first_published_at": "2026-07-22T12:51:43.071000Z",
          "latest_published_at": "2026-07-22T12:51:43.308000Z",
          "latest_version_yanked": null,
          "days_since_latest_publish": 9
        },
        {
          "name": "@llm-ports/adapter-google",
          "exists": true,
          "license": "MIT",
          "keywords": [
            "llm",
            "ai",
            "typescript",
            "google",
            "gemini",
            "google-genai",
            "vision",
            "multimodal",
            "ports-and-adapters",
            "llm-ports",
            "production-llm"
          ],
          "ecosystem": "npm",
          "matches_repo": true,
          "registry_url": "https://www.npmjs.com/package/@llm-ports/adapter-google",
          "is_deprecated": false,
          "latest_version": "0.1.0-alpha.28",
          "repository_url": "https://github.com/baabakk/llm-ports",
          "versions_count": 23,
          "total_downloads": null,
          "dependents_count": null,
          "deprecation_note": null,
          "maintainers_count": 1,
          "monthly_downloads": 1076,
          "first_published_at": "2026-05-21T04:25:17.740000Z",
          "latest_published_at": "2026-07-22T12:51:43.103000Z",
          "latest_version_yanked": null,
          "days_since_latest_publish": 9
        },
        {
          "name": "@llm-ports/adapter-ollama",
          "exists": true,
          "license": "MIT",
          "keywords": [
            "llm",
            "ai",
            "typescript",
            "ollama",
            "local-llm",
            "self-hosted",
            "llama",
            "llama3",
            "mistral",
            "phi",
            "qwen",
            "gemma",
            "ai-sdk",
            "generative-ai",
            "llm-ports",
            "llm-adapter",
            "llm-routing",
            "embeddings",
            "model-management",
            "local-to-cloud",
            "tool-use",
            "vision",
            "multi-provider",
            "offline-llm",
            "privacy"
          ],
          "ecosystem": "npm",
          "matches_repo": true,
          "registry_url": "https://www.npmjs.com/package/@llm-ports/adapter-ollama",
          "is_deprecated": false,
          "latest_version": "0.1.0-alpha.28",
          "repository_url": "https://github.com/baabakk/llm-ports",
          "versions_count": 26,
          "total_downloads": null,
          "dependents_count": null,
          "deprecation_note": null,
          "maintainers_count": 1,
          "monthly_downloads": 1086,
          "first_published_at": "2026-05-12T02:22:26.619000Z",
          "latest_published_at": "2026-07-22T12:51:42.859000Z",
          "latest_version_yanked": null,
          "days_since_latest_publish": 9
        },
        {
          "name": "@llm-ports/adapter-openai",
          "exists": true,
          "license": "MIT",
          "keywords": [
            "llm",
            "ai",
            "typescript",
            "openai",
            "openai-compatible",
            "gpt",
            "gpt-4",
            "gpt-4o",
            "gpt-5",
            "azure-openai",
            "groq",
            "together-ai",
            "fireworks",
            "deepinfra",
            "perplexity",
            "cerebras",
            "litellm",
            "ai-sdk",
            "generative-ai",
            "llm-ports",
            "llm-adapter",
            "llm-routing",
            "llm-fallback",
            "embeddings",
            "tool-use",
            "function-calling",
            "structured-output",
            "vision",
            "multi-provider",
            "cost-control",
            "reasoning-models"
          ],
          "ecosystem": "npm",
          "matches_repo": true,
          "registry_url": "https://www.npmjs.com/package/@llm-ports/adapter-openai",
          "is_deprecated": false,
          "latest_version": "0.1.0-alpha.28",
          "repository_url": "https://github.com/baabakk/llm-ports",
          "versions_count": 30,
          "total_downloads": null,
          "dependents_count": null,
          "deprecation_note": null,
          "maintainers_count": 1,
          "monthly_downloads": 2023,
          "first_published_at": "2026-05-12T02:22:26.648000Z",
          "latest_published_at": "2026-07-22T12:51:43.176000Z",
          "latest_version_yanked": null,
          "days_since_latest_publish": 9
        }
      ]
    },
    "popularity": {
      "forks": 0,
      "stars": 2,
      "watchers": 1,
      "fork_history": {
        "days": [],
        "complete": true,
        "collected": 0,
        "total_forks": 0
      },
      "star_history": null,
      "open_issues_and_prs": 13
    },
    "ai_readiness": {
      "has_nix": false,
      "example_dirs": [
        "examples"
      ],
      "has_llms_txt": false,
      "has_dockerfile": false,
      "has_mcp_signal": false,
      "bootstrap_files": [],
      "api_schema_files": [],
      "has_devcontainer": false,
      "typecheck_configs": [
        "examples/agent-with-approval/tsconfig.json",
        "examples/basic/tsconfig.json",
        "examples/email-triage/tsconfig.json",
        "examples/extract-from-pdf/tsconfig.json",
        "examples/local-with-ollama/tsconfig.json",
        "examples/migrate-from-vercel-ai/tsconfig.json",
        "examples/multi-provider/tsconfig.json",
        "examples/streaming-chat/tsconfig.json",
        "examples/with-onretry/tsconfig.json",
        "packages/adapter-aider/tsconfig.json",
        "packages/adapter-anthropic/tsconfig.json",
        "packages/adapter-codex/tsconfig.json",
        "packages/adapter-contract-tests/tsconfig.json",
        "packages/adapter-google/tsconfig.json",
        "packages/adapter-ollama/tsconfig.json",
        "packages/adapter-openai/tsconfig.json",
        "packages/adapter-vercel/tsconfig.json",
        "packages/benchmarks/tsconfig.json",
        "packages/capabilities/tsconfig.json",
        "packages/consumer-type-check/tsconfig.json",
        "packages/core/tsconfig.json",
        "packages/migrate/tsconfig.json",
        "packages/observability-contract/tsconfig.json"
      ],
      "toolchain_manifests": [],
      "largest_source_bytes": 82975,
      "source_files_sampled": 262,
      "oversized_source_files": 1,
      "agent_instruction_files": [],
      "agent_instruction_max_bytes": null
    },
    "dependencies": {
      "manifests": [
        "package.json"
      ],
      "advisories": {
        "error": null,
        "scope": "published_package",
        "source": "osv",
        "findings": [],
        "collected": true,
        "malicious": [],
        "truncated": false,
        "by_severity": {},
        "advisory_count": 0,
        "affected_count": 0,
        "assessed_count": 1,
        "malicious_count": 0,
        "assessed_package": "npm:@llm-ports/core@0.1.0-alpha.28",
        "unassessed_count": 0,
        "direct_affected_count": 0
      },
      "ecosystems": [
        "npm"
      ],
      "dependencies": [
        {
          "name": "@anthropic-ai/sdk",
          "manifest": "packages/adapter-anthropic/package.json",
          "ecosystem": "npm",
          "version_constraint": "^0.32.1"
        },
        {
          "name": "@llm-ports/core",
          "manifest": "packages/adapter-anthropic/package.json",
          "ecosystem": "npm",
          "version_constraint": "workspace:*"
        },
        {
          "name": "zod-to-json-schema",
          "manifest": "packages/adapter-anthropic/package.json",
          "ecosystem": "npm",
          "version_constraint": "^3.24.1"
        },
        {
          "name": "@llm-ports/core",
          "manifest": "packages/adapter-contract-tests/package.json",
          "ecosystem": "npm",
          "version_constraint": "workspace:*"
        },
        {
          "name": "vitest",
          "manifest": "packages/adapter-contract-tests/package.json",
          "ecosystem": "npm",
          "version_constraint": "^2.1.4"
        },
        {
          "name": "zod",
          "manifest": "packages/adapter-contract-tests/package.json",
          "ecosystem": "npm",
          "version_constraint": "^3.23.0"
        },
        {
          "name": "@llm-ports/core",
          "manifest": "packages/adapter-google/package.json",
          "ecosystem": "npm",
          "version_constraint": "workspace:*"
        },
        {
          "name": "zod-to-json-schema",
          "manifest": "packages/adapter-google/package.json",
          "ecosystem": "npm",
          "version_constraint": "^3.23.5"
        },
        {
          "name": "@llm-ports/core",
          "manifest": "packages/adapter-ollama/package.json",
          "ecosystem": "npm",
          "version_constraint": "workspace:*"
        },
        {
          "name": "ollama",
          "manifest": "packages/adapter-ollama/package.json",
          "ecosystem": "npm",
          "version_constraint": "^0.5.10"
        },
        {
          "name": "@llm-ports/core",
          "manifest": "packages/adapter-openai/package.json",
          "ecosystem": "npm",
          "version_constraint": "workspace:*"
        },
        {
          "name": "openai",
          "manifest": "packages/adapter-openai/package.json",
          "ecosystem": "npm",
          "version_constraint": "^4.73.0"
        },
        {
          "name": "zod-to-json-schema",
          "manifest": "packages/adapter-openai/package.json",
          "ecosystem": "npm",
          "version_constraint": "^3.24.1"
        },
        {
          "name": "@llm-ports/core",
          "manifest": "packages/adapter-vercel/package.json",
          "ecosystem": "npm",
          "version_constraint": "workspace:*"
        },
        {
          "name": "ai",
          "manifest": "packages/adapter-vercel/package.json",
          "ecosystem": "npm",
          "version_constraint": "^4.3.19"
        },
        {
          "name": "@llm-ports/core",
          "manifest": "packages/capabilities/package.json",
          "ecosystem": "npm",
          "version_constraint": "workspace:*"
        },
        {
          "name": "@llm-ports/core",
          "manifest": "packages/consumer-type-check/package.json",
          "ecosystem": "npm",
          "version_constraint": "workspace:*"
        },
        {
          "name": "@llm-ports/capabilities",
          "manifest": "packages/consumer-type-check/package.json",
          "ecosystem": "npm",
          "version_constraint": "workspace:*"
        },
        {
          "name": "zod",
          "manifest": "packages/consumer-type-check/package.json",
          "ecosystem": "npm",
          "version_constraint": "^3.25.76"
        },
        {
          "name": "jsonrepair",
          "manifest": "packages/core/package.json",
          "ecosystem": "npm",
          "version_constraint": "^3.14.0"
        },
        {
          "name": "nanoid",
          "manifest": "packages/observability-contract/package.json",
          "ecosystem": "npm",
          "version_constraint": "^5.0.9"
        }
      ],
      "all_dependencies": {
        "error": "GitHub dependency-graph SBOM unavailable (404); the dependency graph may be disabled for this repository",
        "source": null,
        "packages": [],
        "collected": false,
        "truncated": false,
        "total_count": null,
        "direct_count": null,
        "indirect_count": null
      }
    },
    "maintainership": {
      "issues": {
        "open_prs": 0,
        "merged_prs": 0,
        "open_issues": 13,
        "closed_ratio": 0.639,
        "closed_issues": 23,
        "closed_unmerged_prs": 0
      },
      "bus_factor": 1,
      "bot_contributors": 0,
      "top_contributors": [
        {
          "type": "User",
          "login": "baabakk",
          "commits": 165,
          "avatar_url": "https://avatars.githubusercontent.com/u/11369431?v=4"
        }
      ],
      "contributors_sampled": 1,
      "top_contributor_share": 1
    },
    "quality_signals": {
      "has_ci": true,
      "has_tests": true,
      "ci_workflows": [
        "ci.yml",
        "deploy-docs.yml"
      ],
      "has_docs_dir": true,
      "linter_configs": [
        ".eslintrc.cjs"
      ],
      "has_editorconfig": false,
      "has_linter_config": true,
      "has_precommit_config": false
    },
    "security_signals": {
      "lockfiles": [
        "pnpm-lock.yaml"
      ],
      "scorecard": {
        "checks": [
          {
            "name": "Binary-Artifacts",
            "score": 10,
            "reason": "no binaries found in the repo",
            "documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#binary-artifacts"
          },
          {
            "name": "Branch-Protection",
            "score": 0,
            "reason": "branch protection not enabled on development/release branches",
            "documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#branch-protection"
          },
          {
            "name": "CI-Tests",
            "score": null,
            "reason": "no pull request found",
            "documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#ci-tests"
          },
          {
            "name": "CII-Best-Practices",
            "score": 0,
            "reason": "no effort to earn an OpenSSF best practices badge detected",
            "documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#cii-best-practices"
          },
          {
            "name": "Code-Review",
            "score": 0,
            "reason": "Found 0/30 approved changesets -- score normalized to 0",
            "documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#code-review"
          },
          {
            "name": "Contributors",
            "score": 0,
            "reason": "project has 0 contributing companies or organizations -- score normalized to 0",
            "documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#contributors"
          },
          {
            "name": "Dangerous-Workflow",
            "score": 10,
            "reason": "no dangerous workflow patterns detected",
            "documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#dangerous-workflow"
          },
          {
            "name": "Dependency-Update-Tool",
            "score": 0,
            "reason": "no update tool detected",
            "documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#dependency-update-tool"
          },
          {
            "name": "Fuzzing",
            "score": 0,
            "reason": "project is not fuzzed",
            "documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#fuzzing"
          },
          {
            "name": "License",
            "score": 10,
            "reason": "license file detected",
            "documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#license"
          },
          {
            "name": "Maintained",
            "score": 0,
            "reason": "project was created within the last 90 days. Please review its contents carefully",
            "documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#maintained"
          },
          {
            "name": "Packaging",
            "score": null,
            "reason": "packaging workflow not detected",
            "documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#packaging"
          },
          {
            "name": "Pinned-Dependencies",
            "score": 0,
            "reason": "dependency not pinned by hash detected -- score normalized to 0",
            "documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#pinned-dependencies"
          },
          {
            "name": "SAST",
            "score": 0,
            "reason": "no SAST tool detected",
            "documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#sast"
          },
          {
            "name": "Security-Policy",
            "score": 10,
            "reason": "security policy file detected",
            "documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#security-policy"
          },
          {
            "name": "Signed-Releases",
            "score": null,
            "reason": "no releases found",
            "documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#signed-releases"
          },
          {
            "name": "Token-Permissions",
            "score": 0,
            "reason": "detected GitHub workflow tokens with excessive permissions",
            "documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#token-permissions"
          },
          {
            "name": "Vulnerabilities",
            "score": 0,
            "reason": "22 existing vulnerabilities detected",
            "documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#vulnerabilities"
          }
        ],
        "commit": "d1ed31b72bd6c237f280eeac049113d385a61a79",
        "ran_at": "2026-07-31T16:51:11Z",
        "aggregate_score": 2.8,
        "scorecard_version": "v5.5.0"
      },
      "has_codeql_workflow": false,
      "has_security_policy": true,
      "has_dependabot_config": false
    },
    "contribution_flow": {
      "collected": true,
      "ci_last_run_at": "2026-07-22T12:51:30Z",
      "oldest_open_prs": [],
      "last_merged_pr_at": null,
      "ci_last_conclusion": "SUCCESS",
      "oldest_open_issues": [
        {
          "number": 13,
          "created_at": "2026-05-20T14:34:32Z",
          "last_comment_at": "2026-05-21T03:31:51Z",
          "last_comment_author": "baabakk"
        },
        {
          "number": 17,
          "created_at": "2026-05-20T14:36:17Z",
          "last_comment_at": null,
          "last_comment_author": null
        },
        {
          "number": 30,
          "created_at": "2026-05-26T05:28:13Z",
          "last_comment_at": "2026-05-27T02:32:03Z",
          "last_comment_author": "baabakk"
        },
        {
          "number": 35,
          "created_at": "2026-05-26T20:07:26Z",
          "last_comment_at": null,
          "last_comment_author": null
        },
        {
          "number": 45,
          "created_at": "2026-06-16T23:04:44Z",
          "last_comment_at": null,
          "last_comment_author": null
        },
        {
          "number": 53,
          "created_at": "2026-07-02T08:22:11Z",
          "last_comment_at": null,
          "last_comment_author": null
        },
        {
          "number": 54,
          "created_at": "2026-07-02T08:43:04Z",
          "last_comment_at": null,
          "last_comment_author": null
        },
        {
          "number": 55,
          "created_at": "2026-07-02T08:43:14Z",
          "last_comment_at": null,
          "last_comment_author": null
        },
        {
          "number": 56,
          "created_at": "2026-07-02T08:43:33Z",
          "last_comment_at": null,
          "last_comment_author": null
        },
        {
          "number": 57,
          "created_at": "2026-07-02T08:43:43Z",
          "last_comment_at": null,
          "last_comment_author": null
        },
        {
          "number": 58,
          "created_at": "2026-07-02T08:43:57Z",
          "last_comment_at": null,
          "last_comment_author": null
        },
        {
          "number": 59,
          "created_at": "2026-07-02T08:44:07Z",
          "last_comment_at": null,
          "last_comment_author": null
        },
        {
          "number": 60,
          "created_at": "2026-07-02T08:44:24Z",
          "last_comment_at": "2026-07-10T09:47:18Z",
          "last_comment_author": "richardchen874-sys"
        }
      ]
    }
  },
  "config": {
    "disabled_metrics": [],
    "disabled_categories": [],
    "disabled_components": {}
  },
  "source": {
    "url": "https://github.com/baabakk/llm-ports",
    "host": "github.com",
    "name": "llm-ports",
    "owner": "baabakk"
  },
  "metrics": {
    "overall": {
      "key": "overall",
      "band": "good",
      "name": "Overall health",
      "note": "The weighted overall 60 is calibrated to 65 on the published index scale (record calibration 2026-08-02).",
      "notes": [
        {
          "code": "overall_calibration",
          "params": {
            "raw": 60,
            "calibrated": 65,
            "calibration": "2026-08-02"
          }
        }
      ],
      "value": 65,
      "inputs": {
        "security": 42,
        "vitality": 73,
        "community": 49,
        "governance": 46,
        "calibration": "2026-08-02",
        "engineering": 88,
        "ai_readiness": 55,
        "weighted_overall_raw": 60
      },
      "components": []
    },
    "categories": [
      {
        "key": "vitality",
        "band": "good",
        "name": "Vitality",
        "value": 73,
        "weight": 0.21,
        "metrics": [
          {
            "key": "development_activity",
            "band": "moderate",
            "name": "Development activity",
            "note": null,
            "notes": [],
            "value": 55,
            "inputs": {
              "commits_last_year": 165,
              "human_commit_share": 1,
              "days_since_last_push": 9,
              "active_weeks_last_year": 12
            },
            "components": [
              {
                "key": "push_recency",
                "name": "Push recency",
                "detail": "last push 9 days ago",
                "points": 28.8,
                "status": "partial",
                "details": [
                  {
                    "code": "push_recency",
                    "params": {
                      "days": 9
                    }
                  }
                ],
                "max_points": 36
              },
              {
                "key": "commit_cadence",
                "name": "Commit cadence",
                "detail": "12/52 weeks with commits",
                "points": 8.3,
                "status": "partial",
                "details": [
                  {
                    "code": "commit_cadence_weeks",
                    "params": {
                      "weeks": 12
                    }
                  }
                ],
                "max_points": 36
              },
              {
                "key": "commit_volume",
                "name": "Commit volume",
                "detail": "165 commits in the last year",
                "points": 18,
                "status": "met",
                "details": [
                  {
                    "code": "commits_last_year",
                    "params": {
                      "count": 165
                    }
                  }
                ],
                "max_points": 18
              },
              {
                "key": "openssf_scorecard_maintained",
                "name": "OpenSSF Scorecard: Maintained",
                "detail": "project was created within the last 90 days. Please review its contents carefully",
                "points": 0,
                "status": "missed",
                "details": [],
                "max_points": 10
              }
            ]
          },
          {
            "key": "release_discipline",
            "band": "exceptional",
            "name": "Release discipline",
            "note": "Excluded from scoring (no data or not applicable): OpenSSF Scorecard: Signed-Releases. Remaining weights renormalized.",
            "notes": [
              {
                "code": "excluded_no_data",
                "params": {
                  "components": [
                    "openssf_scorecard_signed_releases"
                  ]
                }
              },
              {
                "code": "weights_renormalized",
                "params": {}
              }
            ],
            "value": 100,
            "inputs": {
              "releases_count": 82,
              "latest_release_tag": "@llm-ports/core@0.1.0-alpha.27",
              "releases_from_tags": false,
              "days_since_latest_release": 13,
              "mean_days_between_releases": 3.8
            },
            "components": [
              {
                "key": "ships_releases",
                "name": "Ships releases",
                "detail": "82 releases published",
                "points": 27,
                "status": "met",
                "details": [
                  {
                    "code": "releases_published",
                    "params": {
                      "count": 82
                    }
                  }
                ],
                "max_points": 27
              },
              {
                "key": "release_recency",
                "name": "Release recency",
                "detail": "latest release 13 days ago",
                "points": 36,
                "status": "met",
                "details": [
                  {
                    "code": "release_recency",
                    "params": {
                      "days": 13
                    }
                  }
                ],
                "max_points": 36
              },
              {
                "key": "release_cadence",
                "name": "Release cadence",
                "detail": "a release every ~3.8 days",
                "points": 27,
                "status": "met",
                "details": [
                  {
                    "code": "release_cadence",
                    "params": {
                      "gap": 3.8
                    }
                  }
                ],
                "max_points": 27
              },
              {
                "key": "openssf_scorecard_signed_releases",
                "name": "OpenSSF Scorecard: Signed-Releases",
                "detail": "no releases found",
                "points": 0,
                "status": "excluded",
                "details": [
                  {
                    "code": "no_data",
                    "params": {}
                  }
                ],
                "max_points": 10
              }
            ]
          },
          {
            "key": "abandonment",
            "band": "exceptional",
            "name": "Abandonment",
            "note": null,
            "notes": [],
            "value": 100,
            "inputs": {
              "cap": null,
              "state": "unverified",
              "guards": [],
              "signals": [],
              "red_flag": false,
              "multiplier_pct": 100,
              "declared_reason": null,
              "unverified_reason": "repository_too_young",
              "unanswered_open_prs": null,
              "unanswered_open_issues": null,
              "days_since_last_merged_pr": null,
              "days_since_last_human_commit": null,
              "days_since_last_human_commit_is_floor": false
            },
            "components": [
              {
                "key": "project_is_still_maintained",
                "name": "Project is still maintained",
                "detail": "maintenance record not established from the collected data",
                "points": 100,
                "status": "met",
                "details": [
                  {
                    "code": "abandonment_unverified",
                    "params": {}
                  }
                ],
                "max_points": 100
              }
            ]
          }
        ],
        "description": "Is the project alive — is code being written and are releases shipping?"
      },
      {
        "key": "community",
        "band": "weak",
        "name": "Community & Adoption",
        "value": 49,
        "weight": 0.17,
        "metrics": [
          {
            "key": "popularity",
            "band": "critical",
            "name": "Popularity & adoption",
            "note": null,
            "notes": [],
            "value": 1,
            "inputs": {
              "forks": 0,
              "stars": 2,
              "watchers": 1,
              "growth_state": "unverified",
              "growth_factor_pct": 100,
              "growth_unverified_reason": "no_history"
            },
            "components": [
              {
                "key": "stars",
                "name": "Stars",
                "detail": "2 stars",
                "points": 0,
                "status": "missed",
                "details": [
                  {
                    "code": "stars",
                    "params": {
                      "count": 2
                    }
                  }
                ],
                "max_points": 60
              },
              {
                "key": "forks",
                "name": "Forks",
                "detail": "0 forks",
                "points": 0,
                "status": "missed",
                "details": [
                  {
                    "code": "forks",
                    "params": {
                      "count": 0
                    }
                  }
                ],
                "max_points": 25
              },
              {
                "key": "watchers",
                "name": "Watchers",
                "detail": "1 watchers",
                "points": 0,
                "status": "missed",
                "details": [
                  {
                    "code": "watchers",
                    "params": {
                      "count": 1
                    }
                  }
                ],
                "max_points": 15
              }
            ]
          },
          {
            "key": "community_health",
            "band": "excellent",
            "name": "Community health",
            "note": null,
            "notes": [],
            "value": 92,
            "inputs": {
              "has_readme": true,
              "has_license": true,
              "readme_badges": null,
              "has_contributing": true,
              "has_issue_template": false,
              "has_code_of_conduct": true,
              "readme_badge_services": [],
              "has_pull_request_template": true
            },
            "components": [
              {
                "key": "readme",
                "name": "README",
                "detail": null,
                "points": 22.5,
                "status": "met",
                "details": [],
                "max_points": 22.5
              },
              {
                "key": "license",
                "name": "License",
                "detail": "recognized license (MIT)",
                "points": 22.5,
                "status": "met",
                "details": [
                  {
                    "code": "license_standard",
                    "params": {}
                  },
                  {
                    "code": "license_spdx",
                    "params": {
                      "spdx": "MIT"
                    }
                  }
                ],
                "max_points": 22.5
              },
              {
                "key": "contributing_guide",
                "name": "CONTRIBUTING guide",
                "detail": null,
                "points": 18,
                "status": "met",
                "details": [],
                "max_points": 18
              },
              {
                "key": "code_of_conduct",
                "name": "Code of conduct",
                "detail": null,
                "points": 13.5,
                "status": "met",
                "details": [],
                "max_points": 13.5
              },
              {
                "key": "issue_template",
                "name": "Issue template",
                "detail": null,
                "points": 0,
                "status": "missed",
                "details": [],
                "max_points": 7.2
              },
              {
                "key": "pr_template",
                "name": "PR template",
                "detail": null,
                "points": 6.3,
                "status": "met",
                "details": [],
                "max_points": 6.3
              }
            ]
          },
          {
            "key": "ecosystem_adoption",
            "band": "good",
            "name": "Ecosystem adoption (downloads)",
            "note": "Excluded from scoring (no data or not applicable): Registry dependents. Remaining weights renormalized.",
            "notes": [
              {
                "code": "excluded_no_data",
                "params": {
                  "components": [
                    "registry_dependents"
                  ]
                }
              },
              {
                "code": "weights_renormalized",
                "params": {}
              }
            ],
            "value": 65,
            "inputs": {
              "packages": [
                "@llm-ports/core",
                "@llm-ports/migrate",
                "@llm-ports/capabilities",
                "@llm-ports/adapter-aider",
                "@llm-ports/adapter-codex",
                "@llm-ports/adapter-google",
                "@llm-ports/adapter-ollama",
                "@llm-ports/adapter-openai"
              ],
              "dependents": null,
              "ecosystems": "npm",
              "total_downloads": null,
              "monthly_downloads": 7563
            },
            "components": [
              {
                "key": "monthly_downloads",
                "name": "Monthly downloads",
                "detail": "7,563 downloads/month across npm",
                "points": 51.7,
                "status": "partial",
                "details": [
                  {
                    "code": "downloads_monthly",
                    "params": {
                      "count": 7563,
                      "ecosystems": "npm"
                    }
                  }
                ],
                "max_points": 80
              },
              {
                "key": "registry_dependents",
                "name": "Registry dependents",
                "detail": "not reported by this ecosystem",
                "points": 0,
                "status": "excluded",
                "details": [
                  {
                    "code": "not_reported_by_this_ecosystem",
                    "params": {}
                  }
                ],
                "max_points": 20
              }
            ]
          }
        ],
        "description": "Does the project have users, downloads, attention, and a welcoming setup for contributors?"
      },
      {
        "key": "governance",
        "band": "weak",
        "name": "Sustainability & Governance",
        "value": 46,
        "weight": 0.23,
        "metrics": [
          {
            "key": "maintainer_resilience",
            "band": "critical",
            "name": "Maintainer resilience (bus factor)",
            "note": null,
            "notes": [],
            "value": 10,
            "inputs": {
              "bus_factor": 1,
              "contributors_sampled": 1,
              "top_contributor_share": 1
            },
            "components": [
              {
                "key": "bus_factor",
                "name": "Bus factor",
                "detail": "1 contributor(s) cover half of all commits",
                "points": 9,
                "status": "partial",
                "details": [
                  {
                    "code": "bus_factor",
                    "params": {
                      "count": 1
                    }
                  }
                ],
                "max_points": 54
              },
              {
                "key": "commit_distribution",
                "name": "Commit distribution",
                "detail": "top contributor authored 100% of commits",
                "points": 0,
                "status": "missed",
                "details": [
                  {
                    "code": "top_contributor_share",
                    "params": {
                      "share": 100
                    }
                  }
                ],
                "max_points": 22.5
              },
              {
                "key": "contributor_breadth",
                "name": "Contributor breadth",
                "detail": "1 contributors",
                "points": 1.4,
                "status": "partial",
                "details": [
                  {
                    "code": "contributors_sampled",
                    "params": {
                      "count": 1
                    }
                  }
                ],
                "max_points": 13.5
              },
              {
                "key": "openssf_scorecard_contributors",
                "name": "OpenSSF Scorecard: Contributors",
                "detail": "project has 0 contributing companies or organizations -- score normalized to 0",
                "points": 0,
                "status": "missed",
                "details": [],
                "max_points": 10
              }
            ]
          },
          {
            "key": "responsiveness",
            "band": "weak",
            "name": "Issue & PR responsiveness",
            "note": "Excluded from scoring (no data or not applicable): PR acceptance, Newcomer PR acceptance. Remaining weights renormalized.",
            "notes": [
              {
                "code": "excluded_no_data",
                "params": {
                  "components": [
                    "pr_acceptance",
                    "newcomer_pr_acceptance"
                  ]
                }
              },
              {
                "code": "weights_renormalized",
                "params": {}
              }
            ],
            "value": 47,
            "inputs": {
              "merged_prs": 0,
              "open_issues": 13,
              "closed_issues": 23,
              "prs_merged_7d": null,
              "prs_decided_7d": null,
              "prs_merged_30d": null,
              "prs_decided_30d": null,
              "issue_closed_ratio": 0.639,
              "closed_unmerged_prs": 0,
              "first_time_authors_30d": null,
              "first_time_prs_merged_30d": null,
              "first_time_prs_decided_30d": null
            },
            "components": [
              {
                "key": "issue_resolution",
                "name": "Issue resolution",
                "detail": "64% of issues closed",
                "points": 26.8,
                "status": "partial",
                "details": [
                  {
                    "code": "issues_closed_share",
                    "params": {
                      "share": 64
                    }
                  }
                ],
                "max_points": 42
              },
              {
                "key": "pr_acceptance",
                "name": "PR acceptance",
                "detail": "no decided pull requests or no data",
                "points": 0,
                "status": "excluded",
                "details": [
                  {
                    "code": "no_decided_prs_or_data",
                    "params": {}
                  }
                ],
                "max_points": 30
              },
              {
                "key": "newcomer_pr_acceptance",
                "name": "Newcomer PR acceptance",
                "detail": "no first-time contributor's PR decided in 30d",
                "points": 0,
                "status": "excluded",
                "details": [
                  {
                    "code": "no_newcomer_prs",
                    "params": {
                      "days": 30
                    }
                  }
                ],
                "max_points": 13
              },
              {
                "key": "openssf_scorecard_code_review",
                "name": "OpenSSF Scorecard: Code-Review",
                "detail": "Found 0/30 approved changesets -- score normalized to 0",
                "points": 0,
                "status": "missed",
                "details": [],
                "max_points": 15
              }
            ]
          },
          {
            "key": "stewardship",
            "band": "weak",
            "name": "Ownership & stewardship",
            "note": "Excluded from scoring (no data or not applicable): Verified domain. Remaining weights renormalized.",
            "notes": [
              {
                "code": "excluded_no_data",
                "params": {
                  "components": [
                    "verified_domain"
                  ]
                }
              },
              {
                "code": "weights_renormalized",
                "params": {}
              }
            ],
            "value": 46,
            "inputs": {
              "followers": 2,
              "owner_type": "User",
              "is_verified": null,
              "owner_login": "baabakk",
              "public_repos": 32,
              "account_age_days": 4163
            },
            "components": [
              {
                "key": "ownership_backing",
                "name": "Ownership backing",
                "detail": "personal (user) account",
                "points": 10,
                "status": "partial",
                "details": [
                  {
                    "code": "owner_personal",
                    "params": {}
                  }
                ],
                "max_points": 30
              },
              {
                "key": "verified_domain",
                "name": "Verified domain",
                "detail": "not applicable to user accounts",
                "points": 0,
                "status": "excluded",
                "details": [
                  {
                    "code": "not_applicable_to_user_accounts",
                    "params": {}
                  }
                ],
                "max_points": 20
              },
              {
                "key": "owner_reach",
                "name": "Owner reach",
                "detail": "2 followers of baabakk",
                "points": 3.4,
                "status": "partial",
                "details": [
                  {
                    "code": "owner_followers",
                    "params": {
                      "count": 2,
                      "login": "baabakk"
                    }
                  }
                ],
                "max_points": 25
              },
              {
                "key": "track_record",
                "name": "Track record",
                "detail": "32 public repos, account ~11 yr old",
                "points": 23.1,
                "status": "partial",
                "details": [
                  {
                    "code": "public_repos",
                    "params": {
                      "count": 32
                    }
                  },
                  {
                    "code": "account_age_years",
                    "params": {
                      "years": 11
                    }
                  }
                ],
                "max_points": 25
              }
            ]
          },
          {
            "key": "package_maintenance",
            "band": "exceptional",
            "name": "Package maintenance",
            "note": null,
            "notes": [],
            "value": 100,
            "inputs": {
              "packages": [
                "@llm-ports/core",
                "@llm-ports/migrate",
                "@llm-ports/capabilities",
                "@llm-ports/adapter-aider",
                "@llm-ports/adapter-codex",
                "@llm-ports/adapter-google",
                "@llm-ports/adapter-ollama",
                "@llm-ports/adapter-openai"
              ],
              "ecosystems": "npm",
              "any_deprecated": false,
              "min_days_since_publish": 9
            },
            "components": [
              {
                "key": "published_resolvable",
                "name": "Published & resolvable",
                "detail": "8 package(s) on npm",
                "points": 25,
                "status": "met",
                "details": [
                  {
                    "code": "packages_published",
                    "params": {
                      "count": 8,
                      "ecosystems": "npm"
                    }
                  }
                ],
                "max_points": 25
              },
              {
                "key": "publish_recency",
                "name": "Publish recency",
                "detail": "latest publish 9 days ago",
                "points": 35,
                "status": "met",
                "details": [
                  {
                    "code": "publish_recency",
                    "params": {
                      "days": 9
                    }
                  }
                ],
                "max_points": 35
              },
              {
                "key": "version_history",
                "name": "Version history",
                "detail": "30 published versions",
                "points": 20,
                "status": "met",
                "details": [
                  {
                    "code": "published_versions",
                    "params": {
                      "count": 30
                    }
                  }
                ],
                "max_points": 20
              },
              {
                "key": "not_deprecated",
                "name": "Not deprecated",
                "detail": "active, not deprecated or yanked",
                "points": 20,
                "status": "met",
                "details": [
                  {
                    "code": "package_not_deprecated",
                    "params": {}
                  }
                ],
                "max_points": 20
              }
            ]
          }
        ],
        "description": "Will the project survive its people — bus factor, responsiveness, who backs it, and package upkeep?"
      },
      {
        "key": "engineering",
        "band": "excellent",
        "name": "Engineering Quality",
        "value": 88,
        "weight": 0.19,
        "metrics": [
          {
            "key": "engineering_practices",
            "band": "excellent",
            "name": "Engineering practices",
            "note": "Excluded from scoring (no data or not applicable): OpenSSF Scorecard: CI-Tests. Remaining weights renormalized.",
            "notes": [
              {
                "code": "excluded_no_data",
                "params": {
                  "components": [
                    "openssf_scorecard_ci_tests"
                  ]
                }
              },
              {
                "code": "weights_renormalized",
                "params": {}
              }
            ],
            "value": 80,
            "inputs": {
              "has_ci": true,
              "has_tests": true,
              "has_editorconfig": false,
              "has_linter_config": true,
              "has_precommit_config": false
            },
            "components": [
              {
                "key": "ci_workflows",
                "name": "CI workflows",
                "detail": "2 workflow(s)",
                "points": 24,
                "status": "met",
                "details": [
                  {
                    "code": "ci_workflows",
                    "params": {
                      "count": 2
                    }
                  }
                ],
                "max_points": 24
              },
              {
                "key": "tests_present",
                "name": "Tests present",
                "detail": null,
                "points": 24,
                "status": "met",
                "details": [],
                "max_points": 24
              },
              {
                "key": "linter_config",
                "name": "Linter config",
                "detail": ".eslintrc.cjs",
                "points": 16,
                "status": "met",
                "details": [
                  {
                    "code": "file_list",
                    "params": {
                      "files": ".eslintrc.cjs"
                    }
                  }
                ],
                "max_points": 16
              },
              {
                "key": "pre_commit_hooks",
                "name": "Pre-commit hooks",
                "detail": null,
                "points": 0,
                "status": "missed",
                "details": [],
                "max_points": 9.6
              },
              {
                "key": "editorconfig",
                "name": ".editorconfig",
                "detail": null,
                "points": 0,
                "status": "missed",
                "details": [],
                "max_points": 6.4
              },
              {
                "key": "openssf_scorecard_ci_tests",
                "name": "OpenSSF Scorecard: CI-Tests",
                "detail": "no pull request found",
                "points": 0,
                "status": "excluded",
                "details": [
                  {
                    "code": "no_data",
                    "params": {}
                  }
                ],
                "max_points": 20
              }
            ]
          },
          {
            "key": "documentation",
            "band": "exceptional",
            "name": "Documentation",
            "note": null,
            "notes": [],
            "value": 100,
            "inputs": {
              "topics": [
                "ai",
                "ai-architecture",
                "anthropic",
                "cost-control",
                "generative-ai",
                "llm",
                "llm-abstraction",
                "llm-fallback",
                "llm-routing",
                "multi-provider",
                "ollama",
                "openai",
                "software-architecture",
                "typescript",
                "vendor-lock-in",
                "multi-provider-ai-support"
              ],
              "has_wiki": true,
              "homepage": "https://baabakk.github.io/llm-ports/",
              "has_readme": true,
              "has_docs_dir": true,
              "has_description": true
            },
            "components": [
              {
                "key": "readme",
                "name": "README",
                "detail": null,
                "points": 30,
                "status": "met",
                "details": [],
                "max_points": 30
              },
              {
                "key": "documentation_directory",
                "name": "Documentation directory",
                "detail": null,
                "points": 25,
                "status": "met",
                "details": [],
                "max_points": 25
              },
              {
                "key": "documentation_homepage_site",
                "name": "Documentation / homepage site",
                "detail": "https://baabakk.github.io/llm-ports/",
                "points": 15,
                "status": "met",
                "details": [],
                "max_points": 15
              },
              {
                "key": "repository_description",
                "name": "Repository description",
                "detail": null,
                "points": 10,
                "status": "met",
                "details": [],
                "max_points": 10
              },
              {
                "key": "topics",
                "name": "Topics",
                "detail": "16 topics",
                "points": 10,
                "status": "met",
                "details": [
                  {
                    "code": "topics_count",
                    "params": {
                      "count": 16
                    }
                  }
                ],
                "max_points": 10
              },
              {
                "key": "wiki",
                "name": "Wiki",
                "detail": null,
                "points": 10,
                "status": "met",
                "details": [],
                "max_points": 10
              }
            ]
          }
        ],
        "description": "Are baseline engineering and documentation practices in place?"
      },
      {
        "key": "security",
        "band": "weak",
        "name": "Security",
        "value": 42,
        "weight": 0.16,
        "metrics": [
          {
            "key": "security_posture",
            "band": "at_risk",
            "name": "Security posture",
            "note": "Excluded from scoring (no data or not applicable): CI-Tests, Packaging, Signed-Releases. Remaining weights renormalized.",
            "notes": [
              {
                "code": "excluded_no_data",
                "params": {
                  "components": [
                    "ci_tests",
                    "packaging",
                    "signed_releases"
                  ]
                }
              },
              {
                "code": "weights_renormalized",
                "params": {}
              }
            ],
            "value": 28,
            "inputs": {
              "source": "openssf_scorecard",
              "checks_evaluated": 15,
              "scorecard_version": "v5.5.0",
              "checks_inconclusive": 3,
              "scorecard_aggregate": 2.8
            },
            "components": [
              {
                "key": "binary_artifacts",
                "name": "Binary-Artifacts",
                "detail": "no binaries found in the repo",
                "points": 7.5,
                "status": "met",
                "details": [],
                "max_points": 7.5
              },
              {
                "key": "branch_protection",
                "name": "Branch-Protection",
                "detail": "branch protection not enabled on development/release branches",
                "points": 0,
                "status": "missed",
                "details": [],
                "max_points": 7.5
              },
              {
                "key": "ci_tests",
                "name": "CI-Tests",
                "detail": "no pull request found",
                "points": 0,
                "status": "excluded",
                "details": [
                  {
                    "code": "no_data",
                    "params": {}
                  }
                ],
                "max_points": 2.5
              },
              {
                "key": "cii_best_practices",
                "name": "CII-Best-Practices",
                "detail": "no effort to earn an OpenSSF best practices badge detected",
                "points": 0,
                "status": "missed",
                "details": [],
                "max_points": 2.5
              },
              {
                "key": "code_review",
                "name": "Code-Review",
                "detail": "Found 0/30 approved changesets -- score normalized to 0",
                "points": 0,
                "status": "missed",
                "details": [],
                "max_points": 7.5
              },
              {
                "key": "contributors",
                "name": "Contributors",
                "detail": "project has 0 contributing companies or organizations -- score normalized to 0",
                "points": 0,
                "status": "missed",
                "details": [],
                "max_points": 2.5
              },
              {
                "key": "dangerous_workflow",
                "name": "Dangerous-Workflow",
                "detail": "no dangerous workflow patterns detected",
                "points": 10,
                "status": "met",
                "details": [],
                "max_points": 10
              },
              {
                "key": "dependency_update_tool",
                "name": "Dependency-Update-Tool",
                "detail": "no update tool detected",
                "points": 0,
                "status": "missed",
                "details": [],
                "max_points": 7.5
              },
              {
                "key": "fuzzing",
                "name": "Fuzzing",
                "detail": "project is not fuzzed",
                "points": 0,
                "status": "missed",
                "details": [],
                "max_points": 5
              },
              {
                "key": "license",
                "name": "License",
                "detail": "license file detected",
                "points": 2.5,
                "status": "met",
                "details": [],
                "max_points": 2.5
              },
              {
                "key": "maintained",
                "name": "Maintained",
                "detail": "project was created within the last 90 days. Please review its contents carefully",
                "points": 0,
                "status": "missed",
                "details": [],
                "max_points": 7.5
              },
              {
                "key": "packaging",
                "name": "Packaging",
                "detail": "packaging workflow not detected",
                "points": 0,
                "status": "excluded",
                "details": [
                  {
                    "code": "no_data",
                    "params": {}
                  }
                ],
                "max_points": 5
              },
              {
                "key": "pinned_dependencies",
                "name": "Pinned-Dependencies",
                "detail": "dependency not pinned by hash detected -- score normalized to 0",
                "points": 0,
                "status": "missed",
                "details": [],
                "max_points": 5
              },
              {
                "key": "sast",
                "name": "SAST",
                "detail": "no SAST tool detected",
                "points": 0,
                "status": "missed",
                "details": [],
                "max_points": 5
              },
              {
                "key": "security_policy",
                "name": "Security-Policy",
                "detail": "security policy file detected",
                "points": 5,
                "status": "met",
                "details": [],
                "max_points": 5
              },
              {
                "key": "signed_releases",
                "name": "Signed-Releases",
                "detail": "no releases found",
                "points": 0,
                "status": "excluded",
                "details": [
                  {
                    "code": "no_data",
                    "params": {}
                  }
                ],
                "max_points": 7.5
              },
              {
                "key": "token_permissions",
                "name": "Token-Permissions",
                "detail": "detected GitHub workflow tokens with excessive permissions",
                "points": 0,
                "status": "missed",
                "details": [],
                "max_points": 7.5
              },
              {
                "key": "vulnerabilities",
                "name": "Vulnerabilities",
                "detail": "22 existing vulnerabilities detected",
                "points": 0,
                "status": "missed",
                "details": [],
                "max_points": 7.5
              }
            ]
          },
          {
            "key": "dependency_advisories",
            "band": "exceptional",
            "name": "Dependency advisories",
            "note": "Excluded from scoring (no data or not applicable): No advisories left outstanding. Remaining weights renormalized. Matched the npm:@llm-ports/core@0.1.0-alpha.28 runtime dependency closure — what installing the published package pulls in — 1 packages. Reachability is not analyzed.",
            "notes": [
              {
                "code": "excluded_no_data",
                "params": {
                  "components": [
                    "no_advisories_left_outstanding"
                  ]
                }
              },
              {
                "code": "weights_renormalized",
                "params": {}
              },
              {
                "code": "advisories_scope_published",
                "params": {
                  "package": "npm:@llm-ports/core@0.1.0-alpha.28",
                  "assessed": 1
                }
              },
              {
                "code": "advisories_reachability",
                "params": {}
              }
            ],
            "value": 100,
            "inputs": {
              "source": "osv",
              "advisories": 0,
              "affected_packages": 0,
              "assessed_packages": 1,
              "unassessed_packages": 0,
              "affected_by_severity": "none",
              "direct_affected_packages": 0
            },
            "components": [
              {
                "key": "direct_dependencies_free_of_known_advisories",
                "name": "Direct dependencies free of known advisories",
                "detail": "no direct dependency carries a known advisory",
                "points": 35,
                "status": "met",
                "details": [
                  {
                    "code": "no_direct_advisories",
                    "params": {}
                  }
                ],
                "max_points": 35
              },
              {
                "key": "indirect_dependencies_free_of_known_advisories",
                "name": "Indirect dependencies free of known advisories",
                "detail": "no indirect dependency carries a known advisory",
                "points": 25,
                "status": "met",
                "details": [
                  {
                    "code": "no_indirect_advisories",
                    "params": {}
                  }
                ],
                "max_points": 25
              },
              {
                "key": "no_advisories_left_outstanding",
                "name": "No advisories left outstanding",
                "detail": "no advisory carries a publication date",
                "points": 0,
                "status": "excluded",
                "details": [
                  {
                    "code": "advisories_no_publication_date",
                    "params": {}
                  }
                ],
                "max_points": 40
              }
            ]
          },
          {
            "key": "malicious_dependencies",
            "band": "exceptional",
            "name": "Malicious dependencies",
            "note": null,
            "notes": [],
            "value": 100,
            "inputs": {
              "source": "osv",
              "meaning": "reported as a malicious package by the OpenSSF corpus; the remedy is removal or moving off the compromised name, never an upgrade of the same artifact. Versions the registry has since pulled are listed but not scored",
              "packages": [],
              "red_flag": false,
              "assessed_packages": 1,
              "malicious_packages": 0,
              "direct_malicious_packages": 0,
              "withdrawn_malicious_packages": 0,
              "installable_malicious_packages": 0
            },
            "components": [
              {
                "key": "no_dependency_reported_as_a_malicious_package",
                "name": "No dependency reported as a malicious package",
                "detail": "no dependency is reported as a malicious package",
                "points": 100,
                "status": "met",
                "details": [
                  {
                    "code": "no_malicious_dependencies",
                    "params": {}
                  }
                ],
                "max_points": 100
              }
            ]
          }
        ],
        "description": "Are visible security and supply-chain practices strong, with no malicious dependency and no unresolved high-risk jurisdiction exposure?"
      },
      {
        "key": "ai_readiness",
        "band": "moderate",
        "name": "AI Readiness",
        "value": 55,
        "weight": 0.04,
        "metrics": [
          {
            "key": "ai_agent_context",
            "band": "weak",
            "name": "Agent context & guidance",
            "note": null,
            "notes": [],
            "value": 40,
            "inputs": {
              "has_llms_txt": false,
              "legible_history_share": 0.99,
              "agent_instruction_files": [],
              "agent_instruction_max_bytes": null
            },
            "components": [
              {
                "key": "agent_instructions",
                "name": "Agent instructions",
                "detail": "no CLAUDE.md / AGENTS.md / editor rules",
                "points": 0,
                "status": "missed",
                "details": [
                  {
                    "code": "no_agent_instructions",
                    "params": {}
                  }
                ],
                "max_points": 45
              },
              {
                "key": "machine_readable_docs_llms_txt",
                "name": "Machine-readable docs (llms.txt)",
                "detail": null,
                "points": 0,
                "status": "missed",
                "details": [],
                "max_points": 15
              },
              {
                "key": "legible_commit_history",
                "name": "Legible commit history",
                "detail": "99 of 100 human commits state their intent (structured subject or explanatory body)",
                "points": 40,
                "status": "met",
                "details": [
                  {
                    "code": "legible_history",
                    "params": {
                      "legible": 99,
                      "sampled": 100
                    }
                  }
                ],
                "max_points": 40
              }
            ]
          },
          {
            "key": "ai_verify_loop",
            "band": "moderate",
            "name": "Verify loop (build / test / typecheck)",
            "note": null,
            "notes": [],
            "value": 54,
            "inputs": {
              "has_nix": false,
              "has_tests": true,
              "lockfiles": [
                "pnpm-lock.yaml"
              ],
              "has_dockerfile": false,
              "typed_language": true,
              "bootstrap_files": [],
              "has_devcontainer": false,
              "has_linter_config": true,
              "typecheck_configs": [
                "examples/agent-with-approval/tsconfig.json",
                "examples/basic/tsconfig.json",
                "examples/email-triage/tsconfig.json",
                "examples/extract-from-pdf/tsconfig.json",
                "examples/local-with-ollama/tsconfig.json",
                "examples/migrate-from-vercel-ai/tsconfig.json",
                "examples/multi-provider/tsconfig.json",
                "examples/streaming-chat/tsconfig.json",
                "examples/with-onretry/tsconfig.json",
                "packages/adapter-aider/tsconfig.json",
                "packages/adapter-anthropic/tsconfig.json",
                "packages/adapter-codex/tsconfig.json",
                "packages/adapter-contract-tests/tsconfig.json",
                "packages/adapter-google/tsconfig.json",
                "packages/adapter-ollama/tsconfig.json",
                "packages/adapter-openai/tsconfig.json",
                "packages/adapter-vercel/tsconfig.json",
                "packages/benchmarks/tsconfig.json",
                "packages/capabilities/tsconfig.json",
                "packages/consumer-type-check/tsconfig.json",
                "packages/core/tsconfig.json",
                "packages/migrate/tsconfig.json",
                "packages/observability-contract/tsconfig.json"
              ],
              "agent_commit_share": 0,
              "toolchain_manifests": [],
              "dependency_bot_commit_share": 0
            },
            "components": [
              {
                "key": "one_command_bootstrap",
                "name": "One-command bootstrap",
                "detail": null,
                "points": 0,
                "status": "missed",
                "details": [],
                "max_points": 18
              },
              {
                "key": "automated_tests",
                "name": "Automated tests",
                "detail": null,
                "points": 22,
                "status": "met",
                "details": [],
                "max_points": 22
              },
              {
                "key": "lint_format_config",
                "name": "Lint / format config",
                "detail": ".eslintrc.cjs",
                "points": 11,
                "status": "met",
                "details": [
                  {
                    "code": "file_list",
                    "params": {
                      "files": ".eslintrc.cjs"
                    }
                  }
                ],
                "max_points": 11
              },
              {
                "key": "static_type_checking",
                "name": "Static type checking",
                "detail": "examples/agent-with-approval/tsconfig.json, examples/basic/tsconfig.json, examples/email-triage/tsconfig.json, examples/extract-from-pdf/tsconfig.json, examples/local-with-ollama/tsconfig.json, examples/migrate-from-vercel-ai/tsconfig.json, examples/multi-provider/tsconfig.json, examples/streaming-chat/tsconfig.json, examples/with-onretry/tsconfig.json, packages/adapter-aider/tsconfig.json, packages/adapter-anthropic/tsconfig.json, packages/adapter-codex/tsconfig.json, packages/adapter-contract-tests/tsconfig.json, packages/adapter-google/tsconfig.json, packages/adapter-ollama/tsconfig.json, packages/adapter-openai/tsconfig.json, packages/adapter-vercel/tsconfig.json, packages/benchmarks/tsconfig.json, packages/capabilities/tsconfig.json, packages/consumer-type-check/tsconfig.json, packages/core/tsconfig.json, packages/migrate/tsconfig.json, packages/observability-contract/tsconfig.json",
                "points": 11,
                "status": "met",
                "details": [
                  {
                    "code": "file_list",
                    "params": {
                      "files": "examples/agent-with-approval/tsconfig.json, examples/basic/tsconfig.json, examples/email-triage/tsconfig.json, examples/extract-from-pdf/tsconfig.json, examples/local-with-ollama/tsconfig.json, examples/migrate-from-vercel-ai/tsconfig.json, examples/multi-provider/tsconfig.json, examples/streaming-chat/tsconfig.json, examples/with-onretry/tsconfig.json, packages/adapter-aider/tsconfig.json, packages/adapter-anthropic/tsconfig.json, packages/adapter-codex/tsconfig.json, packages/adapter-contract-tests/tsconfig.json, packages/adapter-google/tsconfig.json, packages/adapter-ollama/tsconfig.json, packages/adapter-openai/tsconfig.json, packages/adapter-vercel/tsconfig.json, packages/benchmarks/tsconfig.json, packages/capabilities/tsconfig.json, packages/consumer-type-check/tsconfig.json, packages/core/tsconfig.json, packages/migrate/tsconfig.json, packages/observability-contract/tsconfig.json"
                    }
                  }
                ],
                "max_points": 11
              },
              {
                "key": "reproducible_environment",
                "name": "Reproducible environment",
                "detail": "lockfile",
                "points": 10,
                "status": "met",
                "details": [
                  {
                    "code": "file_list",
                    "params": {
                      "files": "lockfile"
                    }
                  }
                ],
                "max_points": 10
              },
              {
                "key": "demonstrated_agent_practice",
                "name": "Demonstrated agent practice",
                "detail": "no agent-authored commits among the last 100",
                "points": 0,
                "status": "missed",
                "details": [
                  {
                    "code": "no_agent_authored_commits",
                    "params": {
                      "sampled": 100
                    }
                  }
                ],
                "max_points": 10
              },
              {
                "key": "automated_maintenance",
                "name": "Automated maintenance",
                "detail": "no automated dependency updates observed",
                "points": 0,
                "status": "missed",
                "details": [
                  {
                    "code": "no_dependency_automation",
                    "params": {}
                  }
                ],
                "max_points": 8
              },
              {
                "key": "openssf_scorecard_pinned_dependencies",
                "name": "OpenSSF Scorecard: Pinned-Dependencies",
                "detail": "dependency not pinned by hash detected -- score normalized to 0",
                "points": 0,
                "status": "missed",
                "details": [],
                "max_points": 10
              }
            ]
          },
          {
            "key": "ai_code_legibility",
            "band": "exceptional",
            "name": "Code legibility for models",
            "note": null,
            "notes": [],
            "value": 100,
            "inputs": {
              "primary_language": "TypeScript",
              "largest_source_bytes": 82975,
              "source_files_sampled": 262,
              "oversized_source_files": 1
            },
            "components": [
              {
                "key": "type_checkable_code",
                "name": "Type-checkable code",
                "detail": "TypeScript (statically typed)",
                "points": 45,
                "status": "met",
                "details": [
                  {
                    "code": "statically_typed_language",
                    "params": {
                      "language": "TypeScript"
                    }
                  }
                ],
                "max_points": 45
              },
              {
                "key": "manageable_file_sizes",
                "name": "Manageable file sizes",
                "detail": "1/262 source files over 60KB",
                "points": 54.8,
                "status": "partial",
                "details": [
                  {
                    "code": "oversized_source_files",
                    "params": {
                      "kb": 60,
                      "sampled": 262,
                      "oversized": 1
                    }
                  }
                ],
                "max_points": 55
              }
            ]
          },
          {
            "key": "ai_interfaces",
            "band": "weak",
            "name": "Machine-readable interfaces",
            "note": null,
            "notes": [],
            "value": 40,
            "inputs": {
              "example_dirs": [
                "examples"
              ],
              "has_mcp_signal": false,
              "api_schema_files": []
            },
            "components": [
              {
                "key": "api_schema_openapi_graphql_proto",
                "name": "API schema (OpenAPI/GraphQL/proto)",
                "detail": null,
                "points": 0,
                "status": "missed",
                "details": [],
                "max_points": 40
              },
              {
                "key": "mcp_server",
                "name": "MCP server",
                "detail": null,
                "points": 0,
                "status": "missed",
                "details": [],
                "max_points": 20
              },
              {
                "key": "runnable_examples",
                "name": "Runnable examples",
                "detail": "examples",
                "points": 40,
                "status": "met",
                "details": [
                  {
                    "code": "file_list",
                    "params": {
                      "files": "examples"
                    }
                  }
                ],
                "max_points": 40
              }
            ]
          }
        ],
        "description": "How well is the repo equipped to be developed and maintained with AI coding agents? Carries a deliberately small weight: agent tooling is a real maintenance signal, but its absence must never gate the top of the scale (calibration saturates at raw 91, so 100/100 remains reachable with AI Readiness at zero)."
      }
    ],
    "classification": {
      "labels": [
        "library"
      ],
      "scores": {
        "library": 6,
        "network-service": 2
      },
      "primary": "library",
      "evidence": [
        {
          "tier": "distribution",
          "label": "library",
          "source": "registry:npm",
          "weight": 6
        },
        {
          "tier": "tags",
          "label": "network-service",
          "source": "tag:self-hosted",
          "weight": 2
        }
      ],
      "artifacts": [],
      "confidence": "medium",
      "host_extension": false,
      "runs_as_process": false,
      "consumed_by_code": true
    },
    "metrics_version": "2.3.1"
  },
  "warnings": [
    "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"
  ],
  "report_type": "repository",
  "generated_at": "2026-07-31T16:51:16.783637Z",
  "schema_version": "0.27.0",
  "badge_url": "https://raw.githubusercontent.com/inspect-software/badges/main/v1/b/baabakk/llm-ports.svg",
  "full_name": "baabakk/llm-ports",
  "license_state": "standard",
  "license_spdx": "MIT"
}

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

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

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