@7n/rules 1.0.0

package/rules/tauri/updater/main.mjs

@@ -0,0 +1,403 @@
+/** @see ./docs/updater.md */
+import { existsSync } from 'node:fs'
+import { readFile } from 'node:fs/promises'
+import { join } from 'node:path'
+
+import { globby } from 'globby'
+
+import { createViolationReporter } from '../../../scripts/lib/lint-surface/violation-reporter.mjs'
+import { getMonorepoPackageRootDirs } from '../../../scripts/lib/workspaces.mjs'
+
+export const MIN_TAURI_COMPONENTS_VERSION = [0, 8, 0]
+const CARGO_TABLE_HEADER_RE = /^\[(.+)\]\s*$/u
+const CARGO_DEP_KEY_RE = /^([A-Za-z0-9_-]+)\s*=/u
+const SEMVER_FLOOR_RE = /(\d+)(?:\.(\d+))?(?:\.(\d+))?/u
+export const CARGO_TARGET_SECTION_RE = /target\./u
+export const CARGO_MOBILE_SECTION_RE = /android|ios/u
+export const CARGO_DESKTOP_TARGET_HEADER =
+  'target.\'cfg(not(any(target_os = "android", target_os = "ios")))\'.dependencies'
+
+/**
+ * Звітує pass/fail через reporter за булевим предикатом — спільна форма для всіх canon-перевірок нижче.
+ * @param {boolean} ok чи пройшла перевірка
+ * @param {string} passMessage повідомлення при успіху
+ * @param {string} failMessage повідомлення при провалі (без суфіксу правила)
+ * @param {string} reason стабільна причина порушення
+ * @param {string} file відносний шлях файла для звіту
+ * @param {ReturnType<typeof createViolationReporter>} reporter репортер концерну
+ * @returns {void}
+ */
+function reportCheck(ok, passMessage, failMessage, reason, file, reporter) {
+  if (ok) {
+    reporter.pass(passMessage)
+  } else {
+    reporter.fail(`${failMessage} (tauri.mdc updater)`, { reason, file })
+  }
+}
+
+/**
+ * Знаходить workspace-каталоги з Tauri-застосунком (`<ws>/src-tauri/tauri.conf.json` чи legacy `<ws>/tauri.conf.json`).
+ * @param {string} cwd корінь репо
+ * @returns {Promise<string[]>} відносні шляхи workspace-каталогів
+ */
+export async function findTauriAppWorkspaces(cwd) {
+  const roots = await getMonorepoPackageRootDirs(cwd)
+  const found = []
+  for (const ws of roots) {
+    const base = ws === '.' ? cwd : join(cwd, ws)
+    const hasMarker =
+      existsSync(join(base, 'src-tauri', 'tauri.conf.json')) || existsSync(join(base, 'tauri.conf.json'))
+    if (hasMarker) found.push(ws)
+  }
+  return found
+}
+
+/**
+ * Розбирає semver-діапазон (`^0.8.0`, `~2.3.1`, `2`) на числові компоненти нижньої межі.
+ * @param {string} range рядок версії з package.json
+ * @returns {number[]} [major, minor, patch] (відсутні компоненти — 0)
+ */
+function parseRangeFloor(range) {
+  const m = SEMVER_FLOOR_RE.exec(range ?? '')
+  if (!m) return [0, 0, 0]
+  return [Number(m[1] ?? 0), Number(m[2] ?? 0), Number(m[3] ?? 0)]
+}
+
+/**
+ * Чи нижня межа `range` >= `min` (порівняння major.minor.patch).
+ * @param {string} range рядок версії
+ * @param {number[]} min мінімальна версія [major, minor, patch]
+ * @returns {boolean} true, якщо range задовольняє мінімум
+ */
+export function meetsMinVersion(range, min) {
+  const v = parseRangeFloor(range)
+  for (const [i, minPart] of min.entries()) {
+    if (v[i] !== minPart) return v[i] > minPart
+  }
+  return true
+}
+
+/**
+ * Чи мажорна версія `range` дорівнює очікуваній.
+ * @param {string} range рядок версії
+ * @param {number} major очікувана мажорна версія
+ * @returns {boolean} true, якщо збігається
+ */
+export function hasMajor(range, major) {
+  return parseRangeFloor(range)[0] === major
+}
+
+/**
+ * Перевіряє package.json workspace-каталогу на канонічні updater-залежності.
+ * @param {string} ws відносний шлях workspace
+ * @param {string} cwd корінь репо
+ * @param {ReturnType<typeof createViolationReporter>} reporter репортер концерну
+ * @returns {Promise<void>} завершується після перевірки
+ */
+async function checkPackageJson(ws, cwd, reporter) {
+  const base = ws === '.' ? cwd : join(cwd, ws)
+  const pkgPath = join(base, 'package.json')
+  if (!existsSync(pkgPath)) return
+  const rel = ws === '.' ? 'package.json' : `${ws}/package.json`
+
+  const pkg = JSON.parse(await readFile(pkgPath, 'utf8'))
+  const deps = { ...pkg.dependencies, ...pkg.devDependencies }
+
+  reportCheck(
+    Boolean(deps['@7n/tauri-components']) &&
+      meetsMinVersion(deps['@7n/tauri-components'], MIN_TAURI_COMPONENTS_VERSION),
+    `${rel}: @7n/tauri-components >=0.8`,
+    `${rel}: потрібна залежність "@7n/tauri-components" >=0.8 — useUpdater() з локальної копії заборонений`,
+    'tauri-components-version',
+    rel,
+    reporter
+  )
+  reportCheck(
+    Boolean(deps['@tauri-apps/plugin-updater']) && hasMajor(deps['@tauri-apps/plugin-updater'], 2),
+    `${rel}: @tauri-apps/plugin-updater ^2`,
+    `${rel}: потрібна залежність "@tauri-apps/plugin-updater" ^2`,
+    'plugin-updater-missing',
+    rel,
+    reporter
+  )
+  reportCheck(
+    Boolean(deps['@tauri-apps/plugin-process']) && hasMajor(deps['@tauri-apps/plugin-process'], 2),
+    `${rel}: @tauri-apps/plugin-process ^2`,
+    `${rel}: потрібна залежність "@tauri-apps/plugin-process" ^2`,
+    'plugin-process-missing',
+    rel,
+    reporter
+  )
+}
+
+/**
+ * Групує рядки Cargo.toml за заголовком секції `[...]` для контекстного пошуку залежностей.
+ * @param {string} content вміст Cargo.toml
+ * @returns {Map<string, string[]>} секція → список ключів-залежностей у ній
+ */
+export function groupCargoDepsBySection(content) {
+  const bySection = new Map()
+  let current = null
+  for (const rawLine of content.split('\n')) {
+    const line = rawLine.trim()
+    const header = CARGO_TABLE_HEADER_RE.exec(line)
+    if (header) {
+      current = header[1]
+      if (!bySection.has(current)) bySection.set(current, [])
+      continue
+    }
+    const kv = CARGO_DEP_KEY_RE.exec(line)
+    if (kv && current) bySection.get(current).push(kv[1])
+  }
+  return bySection
+}
+
+/**
+ * Знаходить назву секції Cargo.toml, що оголошує задану залежність.
+ * @param {Map<string, string[]>} bySection секція → ключі-залежності
+ * @param {string} depName ім'я залежності
+ * @returns {string | null} назва секції або null, якщо не знайдено
+ */
+export function findSectionDeclaring(bySection, depName) {
+  for (const [section, keys] of bySection) {
+    if (keys.includes(depName)) return section
+  }
+  return null
+}
+
+/**
+ * Перевіряє Cargo.toml workspace-каталогу на канонічні updater/process залежності.
+ * @param {string} ws відносний шлях workspace
+ * @param {string} cwd корінь репо
+ * @param {ReturnType<typeof createViolationReporter>} reporter репортер концерну
+ * @returns {Promise<void>} завершується після перевірки
+ */
+async function checkCargoToml(ws, cwd, reporter) {
+  const base = ws === '.' ? cwd : join(cwd, ws)
+  const cargoPath = join(base, 'src-tauri', 'Cargo.toml')
+  if (!existsSync(cargoPath)) return
+  const rel = cargoPath.slice(cwd.length + 1)
+
+  const bySection = groupCargoDepsBySection(await readFile(cargoPath, 'utf8'))
+
+  reportCheck(
+    bySection.values().some(keys => keys.includes('tauri-plugin-process')),
+    `${rel}: tauri-plugin-process присутній`,
+    `${rel}: бракує "tauri-plugin-process" у [dependencies]`,
+    'cargo-plugin-process-missing',
+    rel,
+    reporter
+  )
+
+  const updaterSection = findSectionDeclaring(bySection, 'tauri-plugin-updater')
+  if (updaterSection === null) {
+    reporter.fail(`${rel}: бракує "tauri-plugin-updater" (tauri.mdc updater)`, {
+      reason: 'cargo-plugin-updater-missing',
+      file: rel
+    })
+    return
+  }
+  reportCheck(
+    CARGO_TARGET_SECTION_RE.test(updaterSection) && CARGO_MOBILE_SECTION_RE.test(updaterSection),
+    `${rel}: tauri-plugin-updater desktop-scoped`,
+    `${rel}: "tauri-plugin-updater" має бути в desktop-only [target.'cfg(not(any(target_os = "android", target_os = "ios")))'.dependencies], не в безумовному [dependencies] — плагін не реєструється на mobile`,
+    'cargo-plugin-updater-not-scoped',
+    rel,
+    reporter
+  )
+}
+
+/**
+ * Перевіряє реєстрацію updater/process плагінів у `src-tauri/src/lib.rs`.
+ * @param {string} ws відносний шлях workspace
+ * @param {string} cwd корінь репо
+ * @param {ReturnType<typeof createViolationReporter>} reporter репортер концерну
+ * @returns {Promise<void>} завершується після перевірки
+ */
+async function checkLibRs(ws, cwd, reporter) {
+  const base = ws === '.' ? cwd : join(cwd, ws)
+  const libPath = join(base, 'src-tauri', 'src', 'lib.rs')
+  if (!existsSync(libPath)) return
+  const rel = libPath.slice(cwd.length + 1)
+
+  const raw = await readFile(libPath, 'utf8')
+  const lines = raw.split('\n')
+
+  reportCheck(
+    lines.some(l => l.includes('tauri_plugin_process::init')),
+    `${rel}: tauri_plugin_process зареєстрований`,
+    `${rel}: бракує builder.plugin(tauri_plugin_process::init())`,
+    'lib-rs-process-missing',
+    rel,
+    reporter
+  )
+
+  const updaterIdx = lines.findIndex(l => l.includes('tauri_plugin_updater::Builder'))
+  if (updaterIdx === -1) {
+    reporter.fail(`${rel}: бракує builder.plugin(tauri_plugin_updater::Builder::new().build()) (tauri.mdc updater)`, {
+      reason: 'lib-rs-updater-missing',
+      file: rel
+    })
+    return
+  }
+  const guardLine = lines.slice(0, updaterIdx).findLast(l => l.trim() !== '')
+  reportCheck(
+    Boolean(guardLine?.includes('#[cfg(desktop)]')),
+    `${rel}: tauri_plugin_updater під #[cfg(desktop)]`,
+    `${rel}: tauri_plugin_updater::Builder має бути одразу під #[cfg(desktop)] — інакше mobile-збірка падає`,
+    'lib-rs-updater-not-guarded',
+    rel,
+    reporter
+  )
+}
+
+/**
+ * Збирає всі permission-ідентифікатори з `capabilities/*.json` workspace-каталогу.
+ * @param {string} capDir абсолютний шлях до каталогу capabilities
+ * @returns {Promise<Set<string>>} множина permission-ідентифікаторів
+ */
+async function collectCapabilityPermissionIds(capDir) {
+  const files = await globby('*.json', { cwd: capDir, onlyFiles: true, gitignore: false })
+  const ids = new Set()
+  for (const file of files) {
+    let cap
+    try {
+      cap = JSON.parse(await readFile(join(capDir, file), 'utf8'))
+    } catch {
+      continue
+    }
+    const perms = Array.isArray(cap.permissions) ? cap.permissions : []
+    for (const p of perms) {
+      const id = typeof p === 'string' ? p : p?.identifier
+      if (id) ids.add(id)
+    }
+  }
+  return ids
+}
+
+/**
+ * Перевіряє `capabilities/*.json` на permissions "updater:default" і "process:allow-restart".
+ * @param {string} ws відносний шлях workspace
+ * @param {string} cwd корінь репо
+ * @param {ReturnType<typeof createViolationReporter>} reporter репортер концерну
+ * @returns {Promise<void>} завершується після перевірки
+ */
+async function checkCapabilities(ws, cwd, reporter) {
+  const base = ws === '.' ? cwd : join(cwd, ws)
+  const capDir = join(base, 'src-tauri', 'capabilities')
+  if (!existsSync(capDir)) return
+  const relDir = capDir.slice(cwd.length + 1)
+
+  const ids = await collectCapabilityPermissionIds(capDir)
+
+  reportCheck(
+    ids.has('updater:default'),
+    `${relDir}: updater:default присутній`,
+    `${relDir}/*.json: бракує permission "updater:default" — check() з @7n/tauri-components/vue впаде мовчазним permission-denied, видно лише в console.error`,
+    'capability-updater-missing',
+    relDir,
+    reporter
+  )
+  reportCheck(
+    ids.has('process:allow-restart'),
+    `${relDir}: process:allow-restart присутній`,
+    `${relDir}/*.json: бракує permission "process:allow-restart" — relaunch() після встановлення оновлення впаде`,
+    'capability-process-restart-missing',
+    relDir,
+    reporter
+  )
+}
+
+/**
+ * Перевіряє, що якийсь Vue-компонент викликає `useUpdater()` з `@7n/tauri-components/vue`.
+ * @param {string} ws відносний шлях workspace
+ * @param {string} cwd корінь репо
+ * @param {ReturnType<typeof createViolationReporter>} reporter репортер концерну
+ * @returns {Promise<void>} завершується після перевірки
+ */
+async function checkUseUpdaterCall(ws, cwd, reporter) {
+  const base = ws === '.' ? cwd : join(cwd, ws)
+  const srcDir = join(base, 'src')
+  if (!existsSync(srcDir)) return
+  const relDir = srcDir.slice(cwd.length + 1)
+
+  const files = await globby('**/*.vue', { cwd: srcDir, onlyFiles: true, gitignore: false })
+  let found = false
+  for (const file of files) {
+    const content = await readFile(join(srcDir, file), 'utf8')
+    if (content.includes('@7n/tauri-components/vue') && content.includes('useUpdater()')) {
+      found = true
+      break
+    }
+  }
+
+  reportCheck(
+    found,
+    `${relDir}: useUpdater() викликається`,
+    `${relDir}: жоден *.vue не імпортує useUpdater з "@7n/tauri-components/vue" і не викликає useUpdater() — автооновлення не активується`,
+    'use-updater-not-called',
+    relDir,
+    reporter
+  )
+}
+
+const QUASAR_DIALOG_IMPORT_RE = /import\s*\{[^}]*\bDialog\b[^}]*\}\s*from\s*['"]quasar['"]/u
+const QUASAR_DIALOG_PLUGIN_RE = /plugins\s*:\s*\{[^}]*\bDialog\b/u
+
+/**
+ * Перевіряє, що Quasar-плагін `Dialog` підключено в `src/main.{js,ts}`. Без нього
+ * `useUpdater()` знаходить і навіть завантажує оновлення, але виклик `$q.dialog(...)`
+ * падає з `TypeError: e.dialog is not a function` — помилка тихо ковтається у власному
+ * catch хука, і жоден користувач ніколи не бачить діалог оновлення (виявлено реальним
+ * інцидентом 2026-07-11: check() працював, install() працював, діалогу не було ніде).
+ * @param {string} ws відносний шлях workspace
+ * @param {string} cwd корінь репо
+ * @param {ReturnType<typeof createViolationReporter>} reporter репортер концерну
+ * @returns {Promise<void>} завершується після перевірки
+ */
+async function checkQuasarDialogPlugin(ws, cwd, reporter) {
+  const base = ws === '.' ? cwd : join(cwd, ws)
+  const srcDir = join(base, 'src')
+  if (!existsSync(srcDir)) return
+  const relDir = srcDir.slice(cwd.length + 1)
+
+  const entryFiles = await globby(['main.js', 'main.ts'], { cwd: srcDir, onlyFiles: true, gitignore: false })
+  for (const file of entryFiles) {
+    const content = await readFile(join(srcDir, file), 'utf8')
+    if (!content.includes('Quasar')) continue // не Quasar-застосунок — поза межами цього чека
+
+    const ok = QUASAR_DIALOG_IMPORT_RE.test(content) && QUASAR_DIALOG_PLUGIN_RE.test(content)
+    reportCheck(
+      ok,
+      `${relDir}/${file}: Quasar Dialog plugin підключено`,
+      `${relDir}/${file}: useUpdater() показує оновлення через $q.dialog(...), але Quasar-плагін "Dialog" не в списку plugins: {...} — check()/downloadAndInstall() відпрацьовують, та $q.dialog(...) падає з "e.dialog is not a function"; помилка тихо ковтається в catch, діалог оновлення не з'являється ніколи`,
+      'quasar-dialog-plugin-missing',
+      relDir,
+      reporter
+    )
+  }
+}
+
+/**
+ * @param {import('../../../scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст lint-прогону
+ * @returns {Promise<import('../../../scripts/lib/lint-surface/types.mjs').LintResult>} результат перевірки
+ */
+export async function lint(ctx) {
+  const cwd = ctx.cwd
+  const reporter = createViolationReporter(ctx)
+  const apps = await findTauriAppWorkspaces(cwd)
+  if (apps.length === 0) {
+    return reporter.result()
+  }
+
+  for (const ws of apps) {
+    await checkPackageJson(ws, cwd, reporter)
+    await checkCargoToml(ws, cwd, reporter)
+    await checkLibRs(ws, cwd, reporter)
+    await checkCapabilities(ws, cwd, reporter)
+    await checkUseUpdaterCall(ws, cwd, reporter)
+    await checkQuasarDialogPlugin(ws, cwd, reporter)
+  }
+
+  return reporter.result()
+}

package/rules/tauri/updater/updater.mdc

@@ -0,0 +1,90 @@
+## Автооновлення: `useUpdater()` з `@7n/tauri-components`
+
+Кожен Tauri-застосунок вмикає автооновлення через **спільний** Vue-хук `useUpdater()` з `@7n/tauri-components/vue` — локальні копії цього хука (власна реалізація перевірки/встановлення оновлень) **заборонені**. Джерело канону — `@7n/tauri-components` `npm/src/vue/use-updater.js` і його виклики у чотирьох production Tauri-репо.
+
+### Що робить `useUpdater()`
+
+- **No-op у dev-збірці** (`import.meta.env.DEV`): версія в `tauri.conf.json` — та, що востаннє проставив CI-реліз, а не те, що реально запущено локально, тому dev-збірка завжди вважала б себе застарілою. Це поведінка хука, не місце для локальних обходів.
+- Перша перевірка — через 3 секунди після монтування (`onMounted`), далі — щогодини (`setInterval`).
+- Якщо знайдено оновлення — показує діалог, після згоди завантажує й встановлює, тоді пропонує `relaunch()` (з `@tauri-apps/plugin-process`).
+- Помилки `check()` (мережа, відсутній permission) лише йдуть у `console.error` — без діалогу, щоб не турбувати користувача на кожній мережевій помилці.
+
+### Вимоги до застосунку
+
+Кореневий Vue-компонент (`App.vue`) імпортує й викликає хук без аргументів:
+
+```vue title="src/App.vue"
+<script setup>
+import { useUpdater } from '@7n/tauri-components/vue'
+
+useUpdater()
+</script>
+```
+
+`package.json`:
+
+```json title="package.json"
+{
+  "dependencies": {
+    "@7n/tauri-components": "^0.8.0",
+    "@tauri-apps/plugin-updater": "^2",
+    "@tauri-apps/plugin-process": "^2"
+  }
+}
+```
+
+`src-tauri/Cargo.toml` — `tauri-plugin-updater` реєструється лише для desktop-таргетів (мобільний плагін не існує), `tauri-plugin-process` — безумовно:
+
+```toml title="src-tauri/Cargo.toml"
+[dependencies]
+tauri-plugin-process = "2.3.1"
+
+[target.'cfg(not(any(target_os = "android", target_os = "ios")))'.dependencies]
+tauri-plugin-updater = "2"
+```
+
+`src-tauri/src/lib.rs` — реєстрація плагінів дзеркалить ту саму platform-межу: `tauri-plugin-updater` під `#[cfg(desktop)]`, `tauri-plugin-process` — без cfg-guard (потрібен на будь-якій платформі для `relaunch()`):
+
+```rust title="src-tauri/src/lib.rs"
+#[cfg(desktop)]
+let builder = builder.plugin(tauri_plugin_updater::Builder::new().build());
+
+let builder = builder.plugin(tauri_plugin_process::init());
+```
+
+### Capability: без `updater:default` — тихий фейл
+
+`capabilities/*.json` має надавати `updater:default` і `process:allow-restart`. Обидва permission можна класти прямо в `default.json` (як у застосунках без мобільних таргетів), але якщо в проєкті є мобільні capability-файли — `updater:default` винось в **окремий** capability, обмежений `platforms`, щоб мобільна збірка не тягла desktop-only permission:
+
+```json title="src-tauri/capabilities/updater.json"
+{
+  "identifier": "updater",
+  "windows": ["main"],
+  "platforms": ["macOS", "windows", "linux"],
+  "permissions": ["updater:default"]
+}
+```
+
+```json title="src-tauri/capabilities/default.json"
+{
+  "identifier": "default",
+  "windows": ["main"],
+  "permissions": ["core:default", "process:allow-restart"]
+}
+```
+
+**Без `updater:default` `check()` падає мовчазним permission-denied** — жодного діалогу, жодної помітної помилки користувачу, лише рядок у `console.error`. Це найнебезпечніший режим відмови автооновлення: застосунок виглядає робочим, але жоден користувач ніколи не отримає наступний реліз. Перевіряй `capabilities/*.json` явно після кожної зміни.
+
+### Quasar `Dialog` plugin — друга тиха відмова
+
+`useUpdater()` показує знайдене оновлення через `$q.dialog(...)` (`useQuasar()` з `quasar`). Це вимагає підключеного Quasar-плагіна **`Dialog`** у `src/main.{js,ts}`:
+
+```js title="src/main.js"
+import { Quasar, Dialog, Notify } from 'quasar'
+
+createApp(App).use(Quasar, {
+  plugins: { Dialog, Notify }
+})
+```
+
+**Без `Dialog` у `plugins: {...}`** `check()` і навіть `downloadAndInstall()` відпрацьовують штатно — оновлення реально знаходиться й завантажується, — але виклик `$q.dialog(...)` кидає `TypeError: e.dialog is not a function`. Ця помилка ловиться тим самим catch, що й мережеві — йде в `console.error`, і користувач не бачить **нічого**: ні діалогу пропозиції оновитись, ні діалогу "перезапустити зараз". На відміну від відсутнього permission (де хоча б check() явно падає з помилкою), тут увесь конвеєр до install() працює — тому цей режим відмови важче запідозрити з логів CI/білда. Перевіряй `plugins: { Dialog }` поруч із перевіркою `updater:default` — обидва ламають однаково: мовчки.

package/rules/tauri/vscode_extensions/concern.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "https://unpkg.com/@7n/rules/schemas/concern.json",
+  "fixability": "config",
+  "policy": {
+    "engine": "rego",
+    "files": { "single": ".vscode/extensions.json", "required": true },
+    "missingMessage": ".vscode/extensions.json не існує — додай рекомендовані розширення (tauri.mdc)"
+  }
+}

package/rules/tauri/vscode_extensions/docs/fix-vscode_extensions.md

@@ -0,0 +1,25 @@
+---
+type: JS Module
+title: fix-vscode_extensions.mjs
+resource: npm/rules/tauri/vscode_extensions/fix-vscode_extensions.mjs
+docgen:
+  crc: 3353fe17
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  tier: local-min
+  score: 100
+  issues: judge:inaccurate:0.98
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Цей файл зчитує визначені конфігураційні шаблони з файлу конфігурації, що використовується розширеннями VS Code. Це дозволяє забезпечити послідовне впровадження нових функцій та компонентів у розширення.
+
+## Поведінка
+
+1. Витягує визначені шаблони з файлу `../../../scripts/lib/fix/vscode-ext-add.mjs`.
+2. Повертає ці шаблони.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

package/rules/tauri/vscode_extensions/docs/index.md

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

package/rules/tauri/vscode_extensions/fix-vscode_extensions.mjs

@@ -0,0 +1 @@
+export { patterns } from '../../../scripts/lib/fix/vscode-ext-add.mjs'

package/rules/tauri/vscode_extensions/vscode_extensions.mdc

@@ -0,0 +1,23 @@
+## VS Code розширення для Tauri-проєктів
+
+Rego-пакет: `tauri.vscode_extensions`
+
+Цільовий файл: `.vscode/extensions.json`
+
+Перевіряє, що поле `recommendations` містить розширення `tauri-apps.tauri-vscode`.
+
+Запускається умовно — лише якщо JS-перевірка (`tooling.mjs`) виявила маркер Tauri-проєкту (`src-tauri/`, `tauri.conf.json` або залежність `@tauri-apps/*`). Розширення `rust-lang.rust-analyzer` і `tamasfe.even-better-toml` вимагаються окремо правилом `rust` (rust.mdc).
+
+**✓ Правильно:**
+
+```json
+{ "recommendations": ["tauri-apps.tauri-vscode"] }
+```
+
+**✗ Неправильно:**
+
+```json
+{ "recommendations": ["rust-lang.rust-analyzer"] }
+{ "recommendations": [] }
+{}
+```

package/rules/tauri/vscode_extensions/vscode_extensions.rego

@@ -0,0 +1,26 @@
+# Перевірка `.vscode/extensions.json` для tauri (tauri.mdc).
+#
+# Викликається з `rules/tauri/js/tooling.mjs` через `runConftestBatch` лише
+# ПІСЛЯ того, як JS виявив маркер Tauri-проєкту (`src-tauri/` каталог,
+# `tauri.conf.json` у будь-якому пакеті, або залежність `@tauri-apps/*`).
+# Без `target.json` поруч (не auto-discoverable через `n-rules fix`) — це
+# conditional правило.
+#
+# Canonical (tauri.mdc): `recommendations` має містити `tauri-apps.tauri-vscode`.
+# `rust-lang.rust-analyzer` і `tamasfe.even-better-toml` — вимагаються правилом
+# `rust` (rust.mdc), бо Tauri-проєкт завжди має `src-tauri/Cargo.toml`.
+package tauri.vscode_extensions
+
+import rego.v1
+
+required_extensions := {"tauri-apps.tauri-vscode"}
+
+missing_extension_template := ".vscode/extensions.json: recommendations має містити %q (tauri.mdc)"
+
+recommendations_set := {r | some r in object.get(input, "recommendations", [])}
+
+deny contains msg if {
+	some required in required_extensions
+	not required in recommendations_set
+	msg := sprintf(missing_extension_template, [required])
+}

package/rules/test/cargo_mutants_config/cargo_mutants_config.mdc

@@ -0,0 +1,18 @@
+## Налаштування mutation-testing для Rust: `.cargo/mutants.toml`
+
+Якщо у `.n-rules.json#rules` присутнє правило `rust` — правило `test` створює `.cargo/mutants.toml` у каталозі **кожного** Cargo.toml-маніфесту: кореневий `Cargo.toml`, `<workspace>/src-tauri/Cargo.toml` (Tauri-патерн) і `<workspace>/Cargo.toml` (flat workspace).
+
+Канон cargo-mutants config: [mutants.toml.baseline](./data/cargo_mutants_config/mutants.toml.baseline)
+
+**Customization** (mutate patterns, exclude rules, timeout) — відповідальність проєкту-споживача; концерн лише забезпечує наявність файлу як стартового baseline в кожному з виявлених workspace-каталогів.
+
+### Універсальний baseline і framework-specific tuning
+
+Правило `test` відповідає лише за **універсальний baseline** mutation-testing:
+
+- створює `.cargo/mutants.toml` для Rust crates (порожній, з коментарем);
+- не робить припущень про framework/app shell;
+- не виключає platform glue, generated wrappers або binary entrypoints;
+- framework-specific tuning (`--lib`/`--tests`, `exclude_globs` для app-shell і platform bridge файлів) належить відповідним правилам (`tauri`, `capacitor` тощо).
+
+Якщо інше правило спеціалізує mutation-behavior — воно зобов'язане **доповнювати** існуючий `.cargo/mutants.toml` без дублювання (додавати лише відсутні ключі) і **не перетирати** ручні налаштування. Послідовний запуск `npx @7n/rules fix test` після `fix tauri` не має скидати tauri-tuning, і навпаки — повторний `fix tauri` не дублює секції.

package/rules/test/cargo_mutants_config/concern.json

@@ -0,0 +1,8 @@
+{
+  "$schema": "https://unpkg.com/@7n/rules/schemas/concern.json",
+  "fixability": "config",
+  "lint": {
+    "scope": "full",
+    "glob": ["**/Cargo.toml"]
+  }
+}

package/rules/test/cargo_mutants_config/data/cargo_mutants_config/mutants.toml.baseline

@@ -0,0 +1,7 @@
+# .cargo/mutants.toml — universal cargo-mutants baseline (test.mdc).
+# Цей baseline нейтральний: він не робить припущень про framework/app shell,
+# не виключає platform glue, generated wrappers або binary entrypoints.
+# Framework-specific tuning (Tauri, Capacitor тощо) належить відповідним
+# правилам — вони без дублювання доповнюють цей файл, не перетирають його.
+# cargo-mutants має робочі defaults; цей файл — стартова точка для customization.
+# Документація: https://mutants.rs/