@nitra/cursor 11.4.1 → 12.0.0

package/rules/adr/docs/fix.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: fix.mjs
+resource: npm/rules/adr/fix.mjs
 docgen:
-  source: npm/rules/adr/fix.mjs
   crc: 38cf876b
   score: 100
 ---
 
-# fix.mjs
-
-## Огляд
-
 Виконує обробку JS-занепокоєних та політики на наданому контексті прогону. Генерація посилання MDC та повернення результату прогону.
 
 ## Поведінка

package/rules/adr/docs/index.md

@@ -0,0 +1,11 @@
+---
+type: Directory Index
+title: npm/rules/adr
+resource: npm/rules/adr/
+---
+
+# npm/rules/adr
+
+| Файл | Тип |
+|---|---|
+| [fix.mjs](fix.md) | JS Module |

package/rules/adr/js/docs/hooks.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: hooks.mjs
+resource: npm/rules/adr/js/hooks.mjs
 docgen:
-  source: npm/rules/adr/js/hooks.mjs
   crc: 3f239faf
   score: 100
 ---
 
-# hooks.mjs
-
-## Огляд
-
 Файл надає публічну функцію `check` для валідації даних. Код використовує конфігурацію з файлу `.local.json` для визначення логіки. Функція працює у режимі, де невдачі повертають `false` або `null` замість генерації винятків. Повідомлення про події передаються за допомогою маркера (adr.mdc).
 
 ## Поведінка

package/rules/adr/js/docs/index.md

@@ -0,0 +1,11 @@
+---
+type: Directory Index
+title: npm/rules/adr/js
+resource: npm/rules/adr/js/
+---
+
+# npm/rules/adr/js
+
+| Файл | Тип |
+|---|---|
+| [hooks.mjs](hooks.md) | JS Module |

package/rules/bun/docs/fix.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: fix.mjs
+resource: npm/rules/bun/fix.mjs
 docgen:
-  source: npm/rules/bun/fix.mjs
   crc: 38cf876b
   score: 100
 ---
 
-# fix.mjs
-
-## Огляд
-
 Виконує обробку JS-занепокоєних даних у наданому контексті прогону. Застосовує визначену політику та генерує посилання MDC. Повертає результат прогону.
 
 ## Поведінка

package/rules/bun/docs/index.md

@@ -0,0 +1,11 @@
+---
+type: Directory Index
+title: npm/rules/bun
+resource: npm/rules/bun/
+---
+
+# npm/rules/bun
+
+| Файл | Тип |
+|---|---|
+| [fix.mjs](fix.md) | JS Module |

package/rules/bun/js/docs/index.md

@@ -0,0 +1,11 @@
+---
+type: Directory Index
+title: npm/rules/bun/js
+resource: npm/rules/bun/js/
+---
+
+# npm/rules/bun/js
+
+| Файл | Тип |
+|---|---|
+| [layout.mjs](layout.md) | JS Module |

package/rules/bun/js/docs/layout.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: layout.mjs
+resource: npm/rules/bun/js/layout.mjs
 docgen:
-  source: npm/rules/bun/js/layout.mjs
   crc: ba2a6730
   score: 100
 ---
 
-# layout.mjs
-
-## Огляд
-
 Файл надає інструмент для перевірки відповідності даних визначеному контракту. Функція `check` (bun.mdc) виконує перевірку стану даних і повертає логічний результат, що вказує на успішність виконання перевірки. У разі невдачі функція повертає `false` або `null` замість генерації винятку.
 
 ## Поведінка

package/rules/capacitor/docs/fix.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: fix.mjs
+resource: npm/rules/capacitor/fix.mjs
 docgen:
-  source: npm/rules/capacitor/fix.mjs
   crc: 38cf876b
   score: 100
 ---
 
-# fix.mjs
-
-## Огляд
-
 Виконує застосування JS-занепокоєних на вхідний контекст прогону, застосовує визначену політику, генерує посилання MDC та повертає результат
 
 ## Поведінка

package/rules/capacitor/docs/index.md

@@ -0,0 +1,11 @@
+---
+type: Directory Index
+title: npm/rules/capacitor
+resource: npm/rules/capacitor/
+---
+
+# npm/rules/capacitor
+
+| Файл | Тип |
+|---|---|
+| [fix.mjs](fix.md) | JS Module |

package/rules/capacitor/js/docs/index.md

@@ -0,0 +1,11 @@
+---
+type: Directory Index
+title: npm/rules/capacitor/js
+resource: npm/rules/capacitor/js/
+---
+
+# npm/rules/capacitor/js
+
+| Файл | Тип |
+|---|---|
+| [platforms.mjs](platforms.md) | JS Module |

package/rules/capacitor/js/docs/platforms.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: platforms.mjs
+resource: npm/rules/capacitor/js/platforms.mjs
 docgen:
-  source: npm/rules/capacitor/js/platforms.mjs
   crc: d102129c
   score: 85
 ---
 
-# platforms.mjs
-
-## Огляд
-
 Огляд
 
 Цей файл містить інструменти для витягування та перевірки версій Capacitor з залежностей та конфігурацій. Використовується для визначення сумісності версій Capacitor з конфігураціями, а також для збору даних про версії з різних файлів.

package/rules/changelog/docs/fix.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: fix.mjs
+resource: npm/rules/changelog/fix.mjs
 docgen:
-  source: npm/rules/changelog/fix.mjs
   crc: 38cf876b
   score: 100
 ---
 
-# fix.mjs
-
-## Огляд
-
 Виконує застосування JS-занепокоєних на наданому контексті прогону. Застосовує визначену політику та генерує посилання MDC. Повертає результат прогону.
 
 ## Поведінка

package/rules/changelog/docs/index.md

@@ -0,0 +1,11 @@
+---
+type: Directory Index
+title: npm/rules/changelog
+resource: npm/rules/changelog/
+---
+
+# npm/rules/changelog
+
+| Файл | Тип |
+|---|---|
+| [fix.mjs](fix.md) | JS Module |

package/rules/changelog/js/docs/consistency.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: consistency.mjs
+resource: npm/rules/changelog/js/consistency.mjs
 docgen:
-  source: npm/rules/changelog/js/consistency.mjs
   crc: eaf98d6d
   score: 100
 ---
 
-# consistency.mjs
-
-## Огляд
-
 Перевіряє версіонування проектів у монорепозиторії, порівнюючи версії, зазначені в маніфестах, з даними, отриманими з мережі з https://pypi.org/pypi/. Аналізує відповідність версій встановленим правилам, визначеним у конфігурації res.json. Визначає, чи відповідають версії формату, а також перевіряє наявність змін, порівнюючи їх із даними, описаними у (n-changelog.mdc). При невдачі перевірки повертає false/null, не кидаючи винятків.
 
 ## Поведінка

package/rules/changelog/js/docs/index.md

@@ -0,0 +1,11 @@
+---
+type: Directory Index
+title: npm/rules/changelog/js
+resource: npm/rules/changelog/js/
+---
+
+# npm/rules/changelog/js
+
+| Файл | Тип |
+|---|---|
+| [consistency.mjs](consistency.md) | JS Module |

package/rules/changelog/lib/docs/index.md

@@ -0,0 +1,11 @@
+---
+type: Directory Index
+title: npm/rules/changelog/lib
+resource: npm/rules/changelog/lib/
+---
+
+# npm/rules/changelog/lib
+
+| Файл | Тип |
+|---|---|
+| [package-manifest.mjs](package-manifest.md) | JS Module |

package/rules/changelog/lib/docs/package-manifest.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: package-manifest.mjs
+resource: npm/rules/changelog/lib/package-manifest.mjs
 docgen:
-  source: npm/rules/changelog/lib/package-manifest.mjs
   crc: ced8ad49
 ---
 
-# package-manifest.mjs
-
-## Огляд
-
 Модуль `package-manifest.mjs` реалізує **уніфіковану абстракцію маніфесту пакета** для перевірок changelog у багатомовному монорепо. Він приховує відмінності між двома типами маніфестів:
 
 - **npm / JS** — файл `package.json` (з полями `name`, `version`, `private`, `files`).

package/rules/ci4/docs/fix.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: fix.mjs
+resource: npm/rules/ci4/fix.mjs
 docgen:
-  source: npm/rules/ci4/fix.mjs
   crc: 38cf876b
   score: 100
 ---
 
-# fix.mjs
-
-## Огляд
-
 Огляд
 Файл надає функціонал для виконання визначених правил. Публічні методи забезпечують запуск цих правил, повертаючи отримані результати. Дозволяє запускати правила у режимі командного рядка, керуючи виходом процесу на основі отриманих даних.
 

package/rules/ci4/docs/index.md

@@ -0,0 +1,11 @@
+---
+type: Directory Index
+title: npm/rules/ci4
+resource: npm/rules/ci4/
+---
+
+# npm/rules/ci4
+
+| Файл | Тип |
+|---|---|
+| [fix.mjs](fix.md) | JS Module |

package/rules/ci4/js/docs/index.md

@@ -0,0 +1,11 @@
+---
+type: Directory Index
+title: npm/rules/ci4/js
+resource: npm/rules/ci4/js/
+---
+
+# npm/rules/ci4/js
+
+| Файл | Тип |
+|---|---|
+| [marksman_config.mjs](marksman_config.md) | JS Module |

package/rules/ci4/js/docs/marksman_config.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: marksman_config.mjs
+resource: npm/rules/ci4/js/marksman_config.mjs
 docgen:
-  source: npm/rules/ci4/js/marksman_config.mjs
   crc: 07883aa5
 ---
 
-# marksman_config.mjs
-
-## Огляд
-
 Модуль `marksman_config.mjs` — це концерн правила `ci4` (`ci4.mdc`), що відповідає за матеріалізацію canonical-конфіга для Marksman LSP у корені проєкту. Модуль експортує єдину функцію `check`, яка перевіряє наявність файлу `.marksman.toml` у заданому робочому каталозі (`cwd`) і, якщо файлу немає, копіює туди baseline-варіант, що поставляється з пакета `@nitra/cursor`.
 
 Призначення модуля — забезпечити стабільне, передбачуване середовище для Marksman LSP, який використовується для роботи з Markdown-документами в репо (ADR, документація, README). Без явного `.marksman.toml` Marksman використовує свої вбудовані дефолти, які НЕ збігаються з вимогами правила `ci4.mdc`:

package/rules/doc-files/docs/fix.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: fix.mjs
+resource: npm/rules/doc-files/fix.mjs
 docgen:
-  source: npm/rules/doc-files/fix.mjs
   crc: 9df3e88d
   score: 100
 ---
 
-# fix.mjs
-
-## Огляд
-
 Точка входу правила doc-files для каналу `n-cursor fix doc-files`. Перевіряє структурні вимоги
 правила (наявність потрібного GA-workflow і скрипта в `package.json` через policy-канал), не
 чіпаючи вміст самих док.

package/rules/doc-files/docs/index.md

@@ -0,0 +1,11 @@
+---
+type: Directory Index
+title: npm/rules/doc-files
+resource: npm/rules/doc-files/
+---
+
+# npm/rules/doc-files
+
+| Файл | Тип |
+|---|---|
+| [fix.mjs](fix.md) | JS Module |

package/rules/doc-files/js/docgen-crc.mjs

@@ -30,6 +30,7 @@
  * джерела. На staleness НЕ впливає — звіряється лише `crc`.
  */
 import { existsSync, readFileSync } from 'node:fs'
+import { basename, extname } from 'node:path'
 import { crc32 as zlibCrc32 } from 'node:zlib'
 import { env } from 'node:process'
 
@@ -49,7 +50,7 @@ export function crc32(input) {
 
 /** Провідний YAML-frontmatter-блок `---\n…\n---`. */
 const FRONTMATTER_RE = /^---\n([\s\S]*?)\n---\n?/u
-const SOURCE_RE = /^[ \t]{0,8}source:[ \t]{0,8}(.+)$/mu
+const RESOURCE_RE = /^resource:[ \t]+(.+)$/mu
 const CRC_RE = /^[ \t]{0,8}crc:[ \t]{0,8}(.+)$/mu
 const MODEL_RE = /^[ \t]{0,8}model:[ \t]{0,8}(.+)$/mu
 const SCORE_RE = /^[ \t]{0,8}score:[ \t]{0,8}(\d+)$/mu
@@ -72,9 +73,10 @@ export function parseDocFrontmatter(md) {
   const block = match[1]
   const scoreRaw = block.match(SCORE_RE)?.[1]
   const issuesRaw = block.match(ISSUES_RE)?.[1]
+  const source = block.match(RESOURCE_RE)?.[1].trim() ?? null
   return {
     data: {
-      source: block.match(SOURCE_RE)?.[1].trim() ?? null,
+      source,
       crc: block.match(CRC_RE)?.[1].trim() ?? null,
       model: block.match(MODEL_RE)?.[1].trim() ?? null,
       score: scoreRaw === undefined ? null : Number(scoreRaw),
@@ -94,6 +96,28 @@ export function parseDocFrontmatter(md) {
 /** Максимум кодів issues у frontmatter — це маркер, а не повний лог. */
 const MAX_ISSUE_CODES = 8
 
+/** OKF type для розширення файлу. */
+const EXT_TYPES = {
+  '.js': 'JS Module',
+  '.mjs': 'JS Module',
+  '.cjs': 'JS Module',
+  '.ts': 'TS Module',
+  '.vue': 'Vue Component',
+  '.py': 'Python Module',
+  '.rs': 'Rust Module',
+}
+
+/**
+ * OKF `type` для файлу-джерела за розширенням.
+ * @param {string} sourcePath відносний шлях джерела
+ * @returns {string} тип концепту
+ */
+function typeForSource(sourcePath) {
+  return EXT_TYPES[extname(sourcePath).toLowerCase()] ?? 'Source File'
+}
+
+
+
 /**
  * Нормалізує issues до YAML-безпечних кодів: бере фрагмент до першого пробілу
  * (зрізає людиночитні хвости помилок), відкидає порожні, обмежує кількість.
@@ -108,25 +132,34 @@ function issueCodes(issues) {
 }
 
 /**
- * Будує frontmatter-блок із шляхом джерела, CRC, (опційно) моделлю-генератором і якістю.
+ * Будує OKF-сумісний frontmatter-блок: OKF-поля верхнього рівня + вкладений `docgen:`
+ * з CRC/model/quality. OKF-поля виводяться першими, щоб будь-який OKF-парсер міг їх
+ * читати незалежно від `docgen:`-простору назв.
  * @param {string} source відносний шлях джерела
  * @param {string} crc CRC32 джерела у hex
- * @param {{ score: number, issues?: string[], retried?: boolean, judge?: {model?: string} }|null} [quality] det-оцінка доки (+ опц. `retried`-маркер і `judge.model` хмарного судді); null — без полів якості
+ * @param {{ score: number, issues?: string[], retried?: boolean, judge?: {model?: string} }|null} [quality] det-оцінка доки; null — без полів якості
  * @param {string|null} [model] повний id моделі-генератора; null — без поля `model`
- * @returns {string} рядок `---\ndocgen:\n  source: …\n  crc: …[\n  model: …][\n  score: …][\n  issues: …]\n---\n`
+ * @returns {string} OKF-сумісний YAML frontmatter
  */
 export function buildDocFrontmatter(source, crc, quality = null, model = null) {
-  const lines = [`source: ${source}`, `crc: ${crc}`]
-  if (model) lines.push(`model: ${model}`)
+  const okfLines = [
+    `type: ${typeForSource(source)}`,
+    `title: ${basename(source)}`,
+    `resource: ${source}`,
+  ]
+
+  // docgen namespace: лише CRC-механіка і quality (source перенесено у resource)
+  const docgenLines = [`crc: ${crc}`]
+  if (model) docgenLines.push(`model: ${model}`)
   if (quality && typeof quality.score === 'number') {
-    lines.push(`score: ${quality.score}`)
+    docgenLines.push(`score: ${quality.score}`)
     const codes = issueCodes(quality.issues ?? [])
-    if (codes.length > 0) lines.push(`issues: ${codes.join(',')}`)
-    if (quality.retried) lines.push('retried: true')
-    if (quality.judge && quality.judge.model) lines.push(`judgeModel: ${quality.judge.model}`)
+    if (codes.length > 0) docgenLines.push(`issues: ${codes.join(',')}`)
+    if (quality.retried) docgenLines.push('retried: true')
+    if (quality.judge && quality.judge.model) docgenLines.push(`judgeModel: ${quality.judge.model}`)
   }
-  const indented = lines.map(l => '  ' + l).join('\n')
-  return `---\ndocgen:\n${indented}\n---\n`
+  const indented = docgenLines.map(l => '  ' + l).join('\n')
+  return `---\n${okfLines.join('\n')}\ndocgen:\n${indented}\n---\n`
 }
 
 /**
@@ -138,9 +171,12 @@ export function buildDocFrontmatter(source, crc, quality = null, model = null) {
  * @param {string|null} [model] повний id моделі-генератора; null — без поля `model`
  * @returns {string} md зі свіжим frontmatter
  */
+const LEADING_H1_RE = /^#[^\n]*\n+/u
+
 export function stampDoc(md, source, crc, quality = null, model = null) {
   const { body } = parseDocFrontmatter(md)
-  return `${buildDocFrontmatter(source, crc, quality, model)}\n${body.replace(LEADING_NEWLINES_RE, '')}`
+  const cleanBody = body.replace(LEADING_NEWLINES_RE, '').replace(LEADING_H1_RE, '')
+  return `${buildDocFrontmatter(source, crc, quality, model)}\n${cleanBody}`
 }
 
 /**

package/rules/doc-files/js/docgen-files-batch.mjs

@@ -10,8 +10,8 @@
  * Перед масовим прогоном — health-check omlx: memory-guard зайнятої 8GB машини
  * означає «відклади прогін», а не сотні хибних «✗» у звіті.
  */
-import { readFileSync, mkdirSync, writeFileSync, existsSync, statSync } from 'node:fs'
-import { dirname, join } from 'node:path'
+import { readFileSync, readdirSync, mkdirSync, writeFileSync, existsSync, statSync } from 'node:fs'
+import { basename, dirname, join, relative } from 'node:path'
 
 import { isRunAsCli } from '../../../scripts/cli-entry.mjs'
 import { classifyOmlxError, preflightLocalModel } from '../../../lib/llm.mjs'
@@ -149,6 +149,61 @@ async function generateOne(file, root, progress, stats) {
   }
 }
 
+/** Regex для витягу OKF-полів із frontmatter існуючої доки (швидкий, без YAML-парсера). */
+const OKF_TITLE_RE = /^title: (.+)$/mu
+const OKF_TYPE_RE = /^type: (.+)$/mu
+const OKF_FRONTMATTER_RE = /^---\n([\s\S]*?)\n---\n?/u
+const OKF_RESOURCE_RE = /^resource:[ \t]+(.+)$/mu
+
+/**
+ * Генерує/оновлює `index.md` у директорії `docs/` — OKF Directory Index із таблицею
+ * всіх наявних doc-файлів у цій директорії. Не зачіпає `index.md` при відсутності
+ * інших doc-файлів.
+ * @param {string} docsAbsDir абсолютний шлях директорії `docs/`
+ * @param {string} root абсолютний корінь проєкту
+ * @returns {void}
+ */
+function generateDirIndex(docsAbsDir, root) {
+  const allMd = readdirSync(docsAbsDir).filter(f => f.endsWith('.md')).sort()
+
+  // Якщо index.md вже є дока для source-файлу (має docgen.source → index.*) — не чіпаємо
+  if (allMd.includes('index.md')) {
+    const existingFm = readFileSync(join(docsAbsDir, 'index.md'), 'utf8').match(OKF_FRONTMATTER_RE)?.[1] ?? ''
+    const existingSource = existingFm.match(OKF_RESOURCE_RE)?.[1]?.trim() ?? ''
+    const existingType = existingFm.match(OKF_TYPE_RE)?.[1]?.trim() ?? ''
+    // Пропускаємо якщо це дока source-файлу, а не Directory Index
+    if (existingSource && existingType !== 'Directory Index') return
+  }
+
+  const files = allMd.filter(f => f !== 'index.md')
+  if (files.length === 0) return
+
+  const sourceDirRel = relative(root, dirname(docsAbsDir)) || '.'
+
+  const rows = files.map(f => {
+    const md = readFileSync(join(docsAbsDir, f), 'utf8')
+    const fm = md.match(OKF_FRONTMATTER_RE)?.[1] ?? ''
+    const resource = fm.match(OKF_RESOURCE_RE)?.[1]?.trim()
+    const title = fm.match(OKF_TITLE_RE)?.[1]?.trim() ?? (resource ? basename(resource) : f.replace(/\.md$/, ''))
+    const type = fm.match(OKF_TYPE_RE)?.[1]?.trim() ?? 'Source File'
+    return `| [${title}](${f}) | ${type} |`
+  })
+
+  const content = `---
+type: Directory Index
+title: ${sourceDirRel}
+resource: ${sourceDirRel}/
+---
+
+# ${sourceDirRel}
+
+| Файл | Тип |
+|---|---|
+${rows.join('\n')}
+`
+  writeFileSync(join(docsAbsDir, 'index.md'), content)
+}
+
 /**
  * Підсумковий звіт прогону у stdout.
  * @param {{ ok: number, degraded: number, err: number, errors: string[], skipped: string[] }} stats статистика
@@ -235,6 +290,13 @@ export async function runGenerationBatch(targets, root, { headline } = {}) {
   }
 
   reportStats(stats)
+
+  // Оновлюємо index.md у кожній docs/-директорії, якої торкнувся цей батч
+  const docsDirs = new Set(targets.map(f => dirname(join(root, f.docPath))))
+  for (const docsAbsDir of docsDirs) {
+    if (existsSync(docsAbsDir)) generateDirIndex(docsAbsDir, root)
+  }
+
   if (aborted) return 2
   return stats.err > 0 ? 1 : 0
 }
@@ -261,6 +323,15 @@ export function runDocFilesStampCli(argv) {
     stamped++
   }
   console.log(`✓ fix-doc-files --stamp: оновлено frontmatter у ${stamped} доці(ах).`)
+
+  // Після stamp — оновити index.md у всіх docs/-директоріях
+  const docsDirs = new Set(
+    scanForDocFiles(root)
+      .map(f => dirname(join(root, f.docPath)))
+      .filter(d => existsSync(d))
+  )
+  for (const docsAbsDir of docsDirs) generateDirIndex(docsAbsDir, root)
+
   return 0
 }
 

package/rules/doc-files/js/docs/docgen-crc.md

@@ -1,13 +1,11 @@
 ---
+type: JS Module
+title: docgen-crc.mjs
+resource: npm/rules/doc-files/js/docgen-crc.mjs
 docgen:
-  source: npm/rules/doc-files/js/docgen-crc.mjs
-  crc: 54e8e12b
+  crc: 6baf999b
 ---
 
-# docgen-crc
-
-## Огляд
-
 Детермінований маркер актуальності файлових док: контрольна сума джерела у frontmatter плюс опційний degraded-маркер якості. Єдине джерело правди про «дока свіжа/застаріла/неякісна» для генерації, перевірок і хуків.
 
 ## Поведінка

package/rules/doc-files/js/docs/docgen-extract-anchors.md

@@ -1,14 +1,12 @@
 ---
+type: JS Module
+title: docgen-extract-anchors.mjs
+resource: npm/rules/doc-files/js/docgen-extract-anchors.mjs
 docgen:
-  source: npm/rules/doc-files/js/docgen-extract-anchors.mjs
   crc: 49749e9c
   score: 80
 ---
 
-# docgen-extract-anchors.mjs
-
-## Огляд
-
 Витягує анкори з вихідного коду файлу.
 
 Витягує анкори з вихідного коду файлу.

package/rules/doc-files/js/docs/docgen-extract.md

@@ -1,15 +1,13 @@
 ---
+type: JS Module
+title: docgen-extract.mjs
+resource: npm/rules/doc-files/js/docgen-extract.mjs
 docgen:
-  source: npm/rules/doc-files/js/docgen-extract.mjs
   crc: a0680e77
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
 ---
 
-# docgen-extract.mjs
-
-## Огляд
-
 Витягує структурований факт-лист з вмісту файлів, аналізуючи їх залежно від мови. Для Rust витягує модульний опис, публічні експорти, локальні символи та класифікує імпорти й поведінкові маркери. Для JavaScript/TypeScript/MJS витягує опис, експортовані елементи з JSDoc, класифікує імпорти та визначає поведінкові маркери. При аналізі ігноруються директорії: .github, .git, node_modules, base/, ua/, .firebase. Звертається до мережі та кешує дані протягом одного прогону.
 
 ## Поведінка