@7n/rules 1.25.1 → 1.27.0

package/rules/doc-files/docgen-extract/main.mjs

@@ -1,275 +0,0 @@
-/** @see ./docs/docgen-extract.md */
-
-import { isRunAsCli } from '../../../scripts/cli-entry.mjs'
-import { readFileSync } from 'node:fs'
-
-const BUILTIN_MODULES = new Set([
-  'fs',
-  'path',
-  'crypto',
-  'os',
-  'util',
-  'stream',
-  'events',
-  'http',
-  'https',
-  'url',
-  'child_process',
-  'process',
-  'assert',
-  'buffer',
-  'zlib',
-  'readline'
-])
-
-const JSDOC_OPEN_RE = /^\s*\/\*\*?/
-const JSDOC_CLOSE_RE = /\*\/\s*$/
-const STAR_PREFIX_RE = /^\s*\*?\s?/
-const PARAM_LINE_RE = /^@param[ \t]{1,8}(?:\{[^}]{0,200}\}[ \t]{1,8})?\[?([\w.]{1,80})\]?[ \t]{0,8}(.{0,400})$/
-const RETURNS_LINE_RE = /^@returns?[ \t]{1,8}(?:\{[^}]{0,200}\}[ \t]{1,8})?(.{0,400})$/
-const FILE_HEADER_RE = /^\s*\/\*\*([\s\S]*?)\*\//
-const PRECEDING_JSDOC_RE = /\/\*\*(?:(?!\*\/)[\s\S])*\*\/\s*$/
-const EXPORT_DECL_RE = /export\s+(?:async\s+)?(function|const|class)\s+(\w+)/g
-// Top-level function/class декларації (колонка 0) — для R6: службові функції,
-// які не експортуються, не мають протікати у Поведінку/API як «публічні».
-const TOP_FN_DECL_RE = /^(?:export\s+)?(?:default\s+)?(?:async\s+)?(?:function\*?|class)\s+(\w+)/gm
-const IMPORT_FROM_RE = /^import[ \t]{1,8}[\s\S]{0,300}?from\s{1,8}['"]([^'"]+)['"]/gm
-const NODE_PREFIX_RE = /^node:/
-const INTERNAL_IMPORT_RE = /import[ \t]{1,8}([^'"]{0,300}?)from[ \t]{1,8}['"]\.[^'"]{1,300}['"]/g
-const NAMED_BRACES_RE = /\{([^}]{1,400})\}/
-const IDENT_RE = /^[\w$]{1,80}$/
-const IMPORT_AS_RE = /[ \t]{1,8}as[ \t]{1,8}.{0,200}/
-const WRITE_FS_RE = /\b(writeFile|mkdir|rmdir|unlink|appendFile|createWriteStream|rm\()/
-const CATCH_RE = /catch\s*\(/
-const TRY_RE = /\btry\s*\{/
-// Falsy-return як «fail-safe» — лише коли воно в catch/error-гілці (інакше це
-// звичайний guard `if (!x) return null`, не обробка помилки). Уникає over-claim.
-const FALSY_RETURN_RE = /catch[\s\S]{0,400}?return\s+(false|null|''|"")/
-// Мережа: окрім явного fetch/http, ловимо абстраговані клієнти (graphql/db/rpc/
-// octokit/.request/.query). Хибний false-negative тут = небезпечна гарантія
-// «без мережі», тож свідомо схиляємось до over-detection (м'якший бік помилки).
-const NETWORK_RE =
-  /\bfetch\(|https?:\/\/|\bhttps?\.|axios|\bgot\(|graphql|\.request\(|\.query\(|\.mutate\(|octokit|node-fetch|undici|\bgrpc\b|websocket/i
-// Будь-який `throw` назовні → НЕ можна гарантувати «fail-safe / без винятків».
-const THROW_RE = /\bthrow\s/
-// Запис у БД / зовнішню мутацію → НЕ read-only (навіть якщо нема ФС-запису).
-// Розбито на кілька простіших патернів (та сама семантика через OR у `isMutation`),
-// щоб уникнути надмірної складності одного великого regex.
-const MUTATION_CALL_RE = /\b(insert|update|delete|upsert|drop|destroy|save)[A-Za-z]*\s*[(,]/
-const MUTATION_NAME_RE = /[Mm]utation\b|\bmut[A-Z]\w*/
-const MUTATION_METHOD_RE = /\.(save|create|update|delete|insert|destroy|mutate)\(/
-// Raw-SQL tagged-template виклики (напр. `pgWrite\`UPDATE ...\``) — DML-ключове
-// слово стоїть на початку тіла шаблону, не перед `(`, тож JS-орієнтовані
-// патерни вище його не ловлять. Сигнал мінімальний, але навмисний: тег-функція
-// (ідентифікатор впритул перед `` ` ``) + DML-keyword одразу після відкриття —
-// уникає false positive на звичайних рядках/коментарях, де немає теg-виклику.
-const SQL_TAGGED_MUTATION_RE = /\b\w+`\s*(?:UPDATE|INSERT|MERGE\s+INTO|DELETE\s+FROM|UPSERT)\b/i
-/**
- * @param {string} src вміст файлу
- * @returns {boolean} чи є ознаки мутації БД / зовнішнього стану
- */
-const isMutation = src =>
-  MUTATION_CALL_RE.test(src) ||
-  MUTATION_NAME_RE.test(src) ||
-  MUTATION_METHOD_RE.test(src) ||
-  SQL_TAGGED_MUTATION_RE.test(src)
-// Кеш — лише за ІМЕНОВАНИМ маркером (`cache`/`Cache`/`memoize`), не за будь-яким
-// `new Map()`: акумулятор (напр. `byPath = new Map()`) — не кеш, а хибна гарантія
-// «Кешує результати» гірша за пропуск (фабрикація > мовчання).
-const CACHE_RE = /cache|memoi[sz]e/i
-
-/**
- * Прибирає `/** *​/`-обрамлення й `*`-префікси, повертає чистий текст рядками.
- * @param {string} raw сирий JSDoc-блок з обрамленням
- * @returns {string} очищений текст без обрамлення й префіксів
- */
-function cleanJsDoc(raw) {
-  return raw
-    .replace(JSDOC_OPEN_RE, '')
-    .replace(JSDOC_CLOSE_RE, '')
-    .split('\n')
-    .map(l => l.replace(STAR_PREFIX_RE, '').trimEnd())
-    .join('\n')
-    .trim()
-}
-
-/**
- * Опис (без @-тегів) + параметри з `@param` як «name — опис».
- * @param {string} raw сирий JSDoc-блок
- * @returns {{desc:string, params:Array<{name:string, desc:string}>, ret:string}} розпарсений опис, параметри й опис повернення
- */
-function parseJsDoc(raw) {
-  const text = cleanJsDoc(raw)
-  const lines = text.split('\n')
-  const descLines = []
-  const params = []
-  let ret = ''
-  for (const l of lines) {
-    const pm = l.match(PARAM_LINE_RE)
-    if (pm) {
-      const desc = pm[2].trim()
-      // «опис.» — JSDoc-заглушка без сенсу; не тягнемо її як факт
-      params.push({ name: pm[1], desc: desc === 'опис.' ? '' : desc })
-      continue
-    }
-    const rm = l.match(RETURNS_LINE_RE)
-    if (rm) {
-      ret = rm[1].trim()
-      continue
-    }
-    if (l.startsWith('@')) continue
-    descLines.push(l)
-  }
-  return { desc: descLines.join('\n').trim(), params, ret }
-}
-
-/**
- * Провідний блок-коментар файлу (намір), якщо він перед першим import/кодом.
- * @param {string} src вміст файлу
- * @returns {string} текст header-коментаря або порожній рядок
- */
-function extractFileHeader(src) {
-  const m = src.match(FILE_HEADER_RE)
-  if (!m) return ''
-  // має бути на самому початку (до import/код)
-  if (src.slice(0, m.index).trim() !== '') return ''
-  return parseJsDoc(m[0]).desc
-}
-
-/**
- * Блок-коментар, що стоїть ВПРИТУЛ перед позицією (лише пробіли між ними).
- * `(?:(?!\*​/)[\s\S])*` гарантує, що тіло не містить `*​/`, тож захоплюється рівно один
- * найближчий блок — без жадібного «перестрибування» через імпорти/код.
- * @param {string} prefix вміст файлу до позиції експорту
- * @returns {string|null} JSDoc-блок або null якщо немає
- */
-function precedingJsDoc(prefix) {
-  const m = prefix.match(PRECEDING_JSDOC_RE)
-  return m ? m[0] : null
-}
-
-/**
- * Експорти + JSDoc, що безпосередньо передує кожному.
- * @param {string} src вміст файлу
- * @returns {Array<object>} список експортів із метаданими
- */
-function extractExports(src) {
-  const out = []
-  for (const m of src.matchAll(EXPORT_DECL_RE)) {
-    const [, kind, name] = m
-    const jsdocRaw = precedingJsDoc(src.slice(0, m.index))
-    out.push({ name, kind, ...(jsdocRaw ? parseJsDoc(jsdocRaw) : { desc: '', params: [], ret: '' }) })
-  }
-  return out
-}
-
-/**
- * Імпорти, класифіковані на stdlib / npm / internal.
- * @param {string} src вміст файлу
- * @returns {{stdlib:Array<string>, npm:Array<string>, internal:Array<string>}} розкласифіковані шляхи імпортів
- */
-function extractImports(src) {
-  const internal = new Set(),
-    npm = new Set(),
-    stdlib = new Set()
-  for (const m of src.matchAll(IMPORT_FROM_RE)) {
-    const s = m[1]
-    if (s.startsWith('node:') || BUILTIN_MODULES.has(s.split('/', 1)[0])) stdlib.add(s.replace(NODE_PREFIX_RE, ''))
-    else if (s.startsWith('.') || s.startsWith('/')) internal.add(s)
-    else npm.add(s)
-  }
-  return { stdlib: [...stdlib], npm: [...npm], internal: [...internal] }
-}
-
-/**
- * Імена символів, імпортованих із внутрішніх модулів — їх модель не має згадувати.
- * @param {string} src вміст файлу
- * @returns {Array<string>} список імен внутрішніх символів
- */
-function extractInternalSymbols(src) {
-  const out = new Set()
-  for (const m of src.matchAll(INTERNAL_IMPORT_RE)) {
-    const clause = m[1]
-    const named = clause.match(NAMED_BRACES_RE)
-    if (named) {
-      for (const n of named[1].split(',')) {
-        const name = n.replace(IMPORT_AS_RE, '').trim()
-        if (name) out.add(name)
-      }
-    }
-    const defName = clause.replace(NAMED_BRACES_RE, '').replaceAll(',', ' ').trim().split(' ', 1)[0]
-    if (defName && IDENT_RE.test(defName)) out.add(defName)
-  }
-  return [...out]
-}
-
-/**
- * Імена top-level функцій/класів, які НЕ експортуються (службові помічники).
- * Модель не має подавати їх як «публічні функції» у Поведінці/API (R6).
- * Const-стрілки свідомо не ловимо — менше false-positive на змістовних константах.
- * @param {string} src вміст файлу
- * @returns {Array<string>} список імен неекспортованих функцій/класів
- */
-function extractLocalSymbols(src) {
-  const exported = new Set(Array.from(src.matchAll(EXPORT_DECL_RE), m => m[2]))
-  const out = new Set()
-  for (const m of src.matchAll(TOP_FN_DECL_RE)) {
-    if (!exported.has(m[1])) out.add(m[1])
-  }
-  return [...out]
-}
-
-/**
- * Поведінкові маркери — евристики регулярками.
- * @param {string} src вміст файлу
- * @returns {object} набір прапорців-евристик
- */
-function extractMarkers(src) {
-  // помітні «пропуски»: dir/segment-літерали у фільтрах
-  const skips = new Set()
-  for (const lit of ['.github', '.git', 'node_modules', 'base/', 'ua/', '.firebase']) {
-    if (src.includes(`'${lit}`) || src.includes(`"${lit}`) || src.includes(`/${lit}`)) skips.add(lit)
-  }
-  return {
-    // «Фабрикація > мовчання»: прапорець true лише за high-confidence; інакше
-    // guaranteesFromMarkers/factsSummary його ОПУСКАЮТЬ (не стверджують протилежне).
-    readOnly: !WRITE_FS_RE.test(src) && !isMutation(src), // ні ФС-запису, ні DB-мутацій
-    catchesErrors: (CATCH_RE.test(src) || TRY_RE.test(src)) && !THROW_RE.test(src), // fail-safe лише якщо НЕ кидає
-    returnsFalsyOnFail: FALSY_RETURN_RE.test(src) && !THROW_RE.test(src),
-    network: NETWORK_RE.test(src),
-    caches: CACHE_RE.test(src),
-    skips: [...skips]
-  }
-}
-/**
- * Головний екстрактор: код файлу → факт-лист.
- * @param {string} src вміст файлу
- * @param {string} relPath шлях (для контексту/мови екстрактора)
- * @returns {{relPath:string, lang:string, header:string, exports:Array, imports:object, markers:object}} структура фактів про файл
- */
-export function extractFacts(src, relPath) {
-  const lang = relPath.split('.').pop()
-  if (!['js', 'mjs', 'ts'].includes(lang)) {
-    return { relPath, lang, unsupported: true, header: '', exports: [], imports: {}, markers: {} }
-  }
-  return {
-    relPath,
-    lang,
-    header: extractFileHeader(src),
-    exports: extractExports(src),
-    imports: extractImports(src),
-    internalSymbols: extractInternalSymbols(src),
-    localSymbols: extractLocalSymbols(src),
-    markers: extractMarkers(src)
-  }
-}
-
-// CLI для інспекції: node docgen-extract.mjs <file>
-if (isRunAsCli(import.meta.url)) {
-  const file = process.argv[2]
-  if (!file) {
-    throw new Error('Usage: node docgen-extract.mjs <file>')
-  }
-  const facts = extractFacts(readFileSync(file, 'utf8'), file)
-  console.log(JSON.stringify(facts, null, 2))
-}

package/rules/doc-files/units/concern.json

@@ -1,3 +0,0 @@
-{
-  "$schema": "https://unpkg.com/@7n/rules/schemas/concern.json"
-}

package/rules/doc-files/units/docs/main.md

@@ -1,31 +0,0 @@
----
-type: JS Module
-title: main.mjs
-resource: npm/rules/doc-files/units/main.mjs
-docgen:
-  crc: 8acdefc1
-  model: omlx/gemma-4-e4b-it-OptiQ-4bit
-  score: 100
-  issues: judge:inaccurate:0.98
-  judgeModel: openai-codex/gpt-5.4-mini
----
-
-## Огляд
-
-Цей файл забезпечує аналіз вмісту файлів різного мовного формату для вилучення інформації про юніти. Він обробляє вміст, визначаючи відповідний метод вилучення для JavaScript-подібних або Rust-файлів. Публічна функція `extractUnits` виконує механізм вилучення юнітних даних з коду.
-
-## Поведінка
-
-1. Метод `extractUnits` приймає вміст файлу та його відносний шлях.
-2. Визначається розширення файлу за його відносним шляхом.
-3. Якщо розширення відповідає JavaScript-подібним мовам (js, mjs, ts, jsx, tsx, cts, mts), викликається відповідна функція для вилучення юнітів на основі AST.
-4. Якщо розширення 'rs', викликається відповідна функція для вилучення юнітів шляхом парсингу за допомогою регулярних виразів та підрахунку блоків.
-5. Якщо розширення не підтримується або файл не може бути проаналізований, метод повертає null.
-
-## Публічний API
-
-- extractUnits — Витягує одиниці виміру, визначаючи метод аналізу на основі розширення файлу (від AST для JS/TS до простого пошуку для Vue/Py).
-
-## Гарантії поведінки
-
-- Read-only: не виконує операцій запису (ФС/БД).

package/rules/doc-files/units/main.mjs

@@ -1,19 +0,0 @@
-/** @see ./docs/units.md */
-
-import { extractUnitsJs } from '../units-js/main.mjs'
-
-const JS_EXT = new Set(['js', 'mjs', 'ts', 'jsx', 'tsx', 'cts', 'mts'])
-
-/**
- * Мовно-агностичний фасад юніт-шару. Диспатчить за розширенням:
- * js/mjs/ts → oxc AST; інші мови (rs — lang-плагін, extension-point
- * `doc-files`.extractUnits; vue/py) → null (whole-file шлях).
- * @param {string} src вміст файлу
- * @param {string} relPath шлях файлу
- * @returns {Array<object>|null} юніти або null, якщо мова ще не підтримана / файл не парситься
- */
-export function extractUnits(src, relPath) {
-  const ext = (relPath.split('.').pop() || '').toLowerCase()
-  if (JS_EXT.has(ext)) return extractUnitsJs(src, relPath)
-  return null
-}

package/rules/doc-files/units-js/concern.json

@@ -1,3 +0,0 @@
-{
-  "$schema": "https://unpkg.com/@7n/rules/schemas/concern.json"
-}

package/rules/doc-files/units-js/docs/main.md

@@ -1,32 +0,0 @@
----
-type: JS Module
-title: main.mjs
-resource: npm/rules/doc-files/units-js/main.mjs
-docgen:
-  crc: 395188f4
-  model: omlx/gemma-4-e4b-it-OptiQ-4bit
-  score: 100
-  issues: judge:inaccurate:0.99
-  judgeModel: openai-codex/gpt-5.4-mini
----
-
-## Огляд
-
-Будь ласка, надайте секцію «overview», яку необхідно переписати.
-
-## Поведінка
-
-1. Функція extractUnitsJs аналізує вміст файлу, щоб виявити ідентифіковані юніти (функції, класи, const-функції).
-2. Вона визначає, які юніти є експортованими та обробляє їх для включення до списку.
-3. Для кожного знайденого юніту вона витягує відповідний опис з JSDoc, що передує його оголошенню.
-4. Зібрана інформація про юніт включає його назву, тип (функція, клас, const), прапор експорту, діапазон у вихідному коді та повний вихідний код.
-5. Система виявляє всі виклики інших юнітів у тілі коду кожного юніта.
-6. В результаті повертається список об'єктів, де кожен об'єкт описує один юніт, і в якому вказано лише посилання на інші виявлені юніти.
-
-## Публічний API
-
-extractUnitsJs — знаходить та витягує на верхньому рівні логічні блоки (функції/класи/константи) з файлів JavaScript/TypeScript, які є частиною юніт-шару. Включає інформацію про експорт та взаємодії з іншими юнітами.
-
-## Гарантії поведінки
-
-- Read-only: не виконує операцій запису (ФС/БД).

package/rules/doc-files/units-js/main.mjs

@@ -1,141 +0,0 @@
-/** @see ./docs/units-js.md */
-
-import { parseProgramOrNull, walkAstWithAncestors } from '../../../scripts/utils/ast-scan-utils.mjs'
-
-// JSDoc-блок, що стоїть впритул перед позицією (лише пробіли між ними).
-const JSDOC_BEFORE_RE = /\/\*\*(?:(?!\*\/)[\s\S])*\*\/\s*$/
-const JSDOC_OPEN_RE = /^\s*\/\*\*?/
-const JSDOC_CLOSE_RE = /\*\/\s*$/
-const STAR_PREFIX_RE = /^\s*\*?\s?/
-
-/**
- * Очищає JSDoc від обрамлення `/** *​/` і `*`-префіксів.
- * @param {string} raw сирий блок або порожній рядок
- * @returns {string} текст опису без тегів-обрамлення
- */
-function cleanDoc(raw) {
-  if (!raw) return ''
-  return raw
-    .replace(JSDOC_OPEN_RE, '')
-    .replace(JSDOC_CLOSE_RE, '')
-    .split('\n')
-    .map(l => l.replace(STAR_PREFIX_RE, '').trimEnd())
-    .join('\n')
-    .trim()
-}
-
-/**
- * JSDoc, що передує позиції `start` у джерелі (або порожній рядок).
- * @param {string} src вміст файлу
- * @param {number} start зміщення початку декларації
- * @returns {string} очищений опис
- */
-function precedingDoc(src, start) {
-  const m = src.slice(0, start).match(JSDOC_BEFORE_RE)
-  return cleanDoc(m ? m[0] : '')
-}
-
-/**
- * Імʼя функції, що викликається (проста Identifier або `obj.method`).
- * @param {Record<string, unknown>} node CallExpression
- * @returns {string|null} імʼя callee або null
- */
-function calleeName(node) {
-  const c = node.callee
-  if (!c || typeof c !== 'object') return null
-  if (c.type === 'Identifier') return c.name
-  if (c.type === 'MemberExpression' && !c.computed && c.property?.type === 'Identifier') return c.property.name
-  return null
-}
-
-/**
- * Множина імен, що викликаються у тілі вузла (сирі callee — фільтрація на ребра
- * call-graph робиться у `extractUnitsJs` після збору всіх імен юнітів).
- * @param {unknown} node AST-вузол юніта
- * @returns {Set<string>} імена викликів
- */
-function collectCalls(node) {
-  const names = new Set()
-  walkAstWithAncestors(node, [], n => {
-    if (n.type !== 'CallExpression') {
-      return
-    }
-
-    const name = calleeName(n)
-    if (name) names.add(name)
-  })
-  return names
-}
-
-/**
- * Будує юніт із декларації, додає у `units`. Розпізнає function/class та
- * const-функції (`const x = () => {}` / `function expression`).
- * @param {Record<string, unknown>} decl декларація (function/class/variable)
- * @param {boolean} exported чи експортується
- * @param {number} docStart зміщення для пошуку JSDoc (зовнішній export-вузол)
- * @param {string} src вміст файлу
- * @param {Array<object>} units акумулятор
- * @returns {void}
- */
-function pushUnits(decl, exported, docStart, src, units) {
-  if (!decl || typeof decl !== 'object') return
-  const doc = precedingDoc(src, docStart)
-  if (decl.type === 'FunctionDeclaration' || decl.type === 'ClassDeclaration') {
-    const name = decl.id?.name
-    if (!name) return
-    units.push({
-      name,
-      kind: decl.type === 'ClassDeclaration' ? 'class' : 'function',
-      exported,
-      span: { start: decl.start, end: decl.end },
-      body: src.slice(decl.start, decl.end),
-      calls: collectCalls(decl),
-      doc
-    })
-    return
-  }
-  if (decl.type === 'VariableDeclaration') {
-    for (const d of decl.declarations ?? []) {
-      const init = d.init
-      const isFn = init && (init.type === 'ArrowFunctionExpression' || init.type === 'FunctionExpression')
-      if (!isFn || d.id?.type !== 'Identifier') continue
-      units.push({
-        name: d.id.name,
-        kind: 'const',
-        exported,
-        span: { start: init.start, end: init.end },
-        body: src.slice(init.start, init.end),
-        calls: collectCalls(init),
-        doc
-      })
-    }
-  }
-}
-
-/**
- * Юніт-шар для js/mjs/ts: top-level функції/класи/const-функції з тілом, JSDoc,
- * прапором експорту і ребрами call-graph (виклики ІНШИХ юнітів у тілі).
- * @param {string} src вміст файлу
- * @param {string} [relPath] шлях (для вибору мови oxc)
- * @returns {Array<{name:string, kind:string, exported:boolean, span:{start:number,end:number}, body:string, calls:string[], doc:string}>|null} юніти або null, якщо файл не парситься
- */
-export function extractUnitsJs(src, relPath = 'scan.ts') {
-  const program = parseProgramOrNull(src, relPath)
-  if (!program || !Array.isArray(program.body)) return null
-
-  const units = []
-  for (const node of program.body) {
-    const isExport =
-      (node.type === 'ExportNamedDeclaration' || node.type === 'ExportDefaultDeclaration') && node.declaration
-    if (isExport) {
-      pushUnits(node.declaration, true, node.start, src, units)
-    } else {
-      pushUnits(node, false, node.start, src, units)
-    }
-  }
-
-  // Ребра call-graph: лишаємо тільки виклики інших внутрішніх юнітів
-  const names = new Set(units.map(u => u.name))
-  for (const u of units) u.calls = [...u.calls].filter(n => names.has(n) && n !== u.name)
-  return units
-}

package/skills/taze/js/diff.mjs

@@ -1,140 +0,0 @@
-/** @see ./docs/diff.md */
-import { existsSync } from 'node:fs'
-import { readFile } from 'node:fs/promises'
-import { join } from 'node:path'
-
-import { getMonorepoPackageRootDirs } from '../../../scripts/lib/workspaces.mjs'
-
-/** Поля package.json із залежностями, які порівнюємо. */
-const DEP_FIELDS = ['dependencies', 'devDependencies', 'peerDependencies', 'optionalDependencies']
-
-/** Дефолтний суфікс бекапу, який створює крок 1 скіла (`cp package.json package.json.taze-bak`). */
-const DEFAULT_BACKUP_SUFFIX = '.taze-bak'
-
-// Заякорено на початок (після можливих range-операторів `^~>=<`, пробілів, `v`),
-// щоб НЕ ловити версію всередині protocol-specifier-ів (`workspace:1.0.0`, `npm:x@1.2.3`).
-const SEMVER_RE = /^[\s~^>=<v]*(\d+)\.(\d+)\.(\d+)/
-
-/**
- * Парсить semver-ядро зі specifier-а (ігнорує range-префікси `^`/`~`/`>=` тощо).
- * @param {string} spec версійний specifier із package.json
- * @returns {{major:number, minor:number, patch:number}|null} ядро або null для не-semver (`workspace:*`, git-url, `*`)
- */
-export function parseVersion(spec) {
-  if (typeof spec !== 'string') return null
-  const m = SEMVER_RE.exec(spec)
-  if (!m) return null
-  return { major: Number(m[1]), minor: Number(m[2]), patch: Number(m[3]) }
-}
-
-/**
- * Чи є перехід `from → to` breaking за caret-семантикою (змінилась найлівіша
- * ненульова компонента).
- * @param {{major:number,minor:number,patch:number}} from стара версія
- * @param {{major:number,minor:number,patch:number}} to нова версія
- * @returns {boolean} true — major/breaking
- */
-export function isBreaking(from, to) {
-  if (from.major !== to.major) return true
-  if (from.major > 0) return false
-  if (from.minor !== to.minor) return true
-  if (from.minor > 0) return false
-  return from.patch !== to.patch
-}
-
-/**
- * Порівнює два package.json-обʼєкти й повертає зміни залежностей.
- * @param {object} oldPkg розпарсений старий package.json (бекап)
- * @param {object} newPkg розпарсений новий package.json
- * @param {string} workspace мітка воркспейсу (`.` для кореня)
- * @returns {{major: Array<{workspace:string, pkg:string, from:string, to:string}>, minorPatch:number}} зміни
- */
-export function diffPackageJson(oldPkg, newPkg, workspace) {
-  const major = []
-  let minorPatch = 0
-  for (const field of DEP_FIELDS) {
-    const oldDeps = oldPkg?.[field]
-    const newDeps = newPkg?.[field]
-    if (!oldDeps || !newDeps) continue
-    for (const [pkg, from] of Object.entries(oldDeps)) {
-      const to = newDeps[pkg]
-      if (to === undefined || to === from) continue
-      const fromV = parseVersion(from)
-      const toV = parseVersion(to)
-      if (fromV && toV && isBreaking(fromV, toV)) {
-        major.push({ workspace, pkg, from, to })
-      } else {
-        minorPatch += 1
-      }
-    }
-  }
-  return { major, minorPatch }
-}
-
-/**
- * Читає JSON-файл або повертає null, якщо файл відсутній / невалідний.
- * @param {string} path абсолютний шлях
- * @returns {Promise<object|null>} розпарсений обʼєкт або null
- */
-async function readJsonOrNull(path) {
-  if (!existsSync(path)) return null
-  try {
-    return JSON.parse(await readFile(path, 'utf8'))
-  } catch {
-    return null
-  }
-}
-
-/**
- * Збирає diff по всьому монорепо: для кожного воркспейсу порівнює
- * `<ws>/package.json` з `<ws>/package.json<backupSuffix>`.
- * @param {string} cwd корінь репозиторію
- * @param {string} [backupSuffix] суфікс бекап-файлу
- * @returns {Promise<{major: Array<{workspace:string, pkg:string, from:string, to:string}>, minorPatch:number, totalChanged:number, comparedWorkspaces:number}>} агрегований diff
- */
-export async function collectTazeDiff(cwd, backupSuffix = DEFAULT_BACKUP_SUFFIX) {
-  const roots = await getMonorepoPackageRootDirs(cwd)
-  const major = []
-  let minorPatch = 0
-  let comparedWorkspaces = 0
-  for (const ws of roots) {
-    const dir = join(cwd, ws)
-    const oldPkg = await readJsonOrNull(join(dir, `package.json${backupSuffix}`))
-    const newPkg = await readJsonOrNull(join(dir, 'package.json'))
-    if (!oldPkg || !newPkg) continue
-    comparedWorkspaces += 1
-    const res = diffPackageJson(oldPkg, newPkg, ws)
-    major.push(...res.major)
-    minorPatch += res.minorPatch
-  }
-  return { major, minorPatch, totalChanged: major.length + minorPatch, comparedWorkspaces }
-}
-
-const USAGE = 'Usage: n-rules taze diff [--backup-suffix <suffix>]'
-
-/**
- * CLI: `n-rules taze diff` друкує компактний JSON зі списком major-оновлень і
- * лічбою minor/patch. Read-only.
- * @param {string[]} args аргументи після `taze`
- * @param {string} [cwd] корінь репозиторію (ін'єкція для тестів)
- * @returns {Promise<number>} exit code
- */
-export async function runTazeCli(args, cwd = process.cwd()) {
-  if (args[0] !== 'diff') {
-    console.error(USAGE)
-    return 1
-  }
-  const flagAt = args.indexOf('--backup-suffix')
-  const backupSuffix = flagAt === -1 ? DEFAULT_BACKUP_SUFFIX : args[flagAt + 1]
-  if (!backupSuffix) {
-    console.error(USAGE)
-    return 1
-  }
-  const diff = await collectTazeDiff(cwd, backupSuffix)
-  if (diff.comparedWorkspaces === 0) {
-    console.error(`✗ Не знайдено жодного package.json${backupSuffix} — спершу зроби бекап (крок 1 скіла).`)
-    return 1
-  }
-  process.stdout.write(`${JSON.stringify(diff)}\n`)
-  return 0
-}