---
docgen:
  source: npm/skills/doc-files/js/docgen-gen.mjs
  crc: e2af04d6
  score: 100
---

# docgen-gen.mjs

## Огляд

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

## Поведінка

splitProtected
Вибирає та видаляє код-фенс-обгортку з секції

insertProtected
Вставляє захищений блок Призначення після заголовка Огляд

scoreDoc
Перевіряє вихід проти фактів і повертає оцінку та список проблем

DEFAULT_LOCAL_MODEL
Повертає дефолтну модель для роботи

generateDoc
Генерує документ з детермінованою оцінкою та метаданими

## Публічний API

splitProtected — Відокремлює захищену секцію `## Призначення` (Варіант B). Межа — наступний `## ` і `###` не обриває блок. (abie.mdc)
insertProtected — Вставляє захищений блок `## Призначення` одразу після H1 (фіксована позиція). (abie.mdc)
scoreDoc — Stage 2.5 — Детермінований скоринг (0 токенів): перевіряє вихід проти фактів. (abie.mdc)
DEFAULT_LOCAL_MODEL — Дефолтна модель: N_CURSOR_DOCGEN_MODEL → resolveModel → omlx напряму. Останній fallback гарантує локальний виклик без змін середовища (через pi CLI той самий локальний виклик виміряно повільніший на ~46%). (abie.mdc)
generateDoc — Головний API: файл → md-дока з det-оцінкою. (abie.mdc)

## Гарантії поведінки

- Read-only: файл не виконує операцій запису у файлову систему.
- Перехоплює помилки і не пропускає винятків назовні (fail-safe).
- За невдачі повертає значення помилки (`false`/`null`/`Err`) замість генерування винятку чи паніки.
- Кешує результати в межах одного прогону.
- Не звертається до мережі.
