@7n/rules 1.0.0

package/rules/tauri/cargo_mutants_config/main.mjs

@@ -0,0 +1,148 @@
+/**
+ * @see ./docs/cargo_mutants_config.md
+ *
+ * Read-only detector: лише ЗВІТУЄ про відсутній чи неповний
+ * `<ws>/src-tauri/.cargo/mutants.toml` (відсутні канонічні Tauri-ключі).
+ * Створення/augment baseline — окремий T0-fix (`fix-cargo_mutants_config.mjs`),
+ * не в detector-і (`lint --no-fix` ніколи не мутує дерево). Спільні білдери
+ * baseline/append-блоку експортуємо для T0.
+ */
+import { existsSync } from 'node:fs'
+import { readFile } from 'node:fs/promises'
+import { join, relative } from 'node:path'
+
+import { parse as parseToml } from 'smol-toml'
+
+import { createViolationReporter } from '../../../scripts/lib/lint-surface/violation-reporter.mjs'
+import { getMonorepoPackageRootDirs } from '../../../scripts/lib/workspaces.mjs'
+
+/** Стабільні reasons: файл відсутній / у файлі бракує канонічних Tauri-ключів. */
+export const MUTANTS_CONFIG_MISSING = 'mutants-config-missing'
+export const MUTANTS_KEYS_MISSING = 'mutants-keys-missing'
+
+export const TAURI_BASELINE_HEADER = `# .cargo/mutants.toml — Tauri canonical cargo-mutants config (tauri.mdc).
+# Виключаємо --bins і --doc щоб бінарник Tauri та doc-tests не збиралися повторно
+# з нуля під кожного мутанта (секунди → хвилини).
+`
+
+export const TAURI_KEY_SNIPPETS = Object.freeze({
+  additional_cargo_test_args: 'additional_cargo_test_args = ["--lib", "--tests"]\n',
+  exclude_globs: `# Platform bridge / app shell — boundary-файли (тестуються smoke/e2e, не mutation unit).
+# Якщо у bridge-файлі з'являється pure/business logic — винеси її у platform-neutral
+# модуль (src/auth/oauth.rs, src/gmail/message.rs, ...) і тестуй mutation-testing там.
+# src/lib.rs (Tauri pub fn run) — runtime entrypoint, що запускає весь app shell:
+# один мутант там тримає весь Tauri runtime, тому ділить sandbox-фейл з src/main.rs.
+exclude_globs = [
+  "src/main.rs",
+  "src/lib.rs",
+  "src/**/android.rs",
+  "src/**/ios.rs",
+  "src/**/mobile.rs",
+  "src/**/desktop.rs",
+  "src/**/macos.rs",
+  "src/**/windows.rs",
+  "src/**/linux.rs"
+]
+`
+})
+
+export const TAURI_CANONICAL_KEYS = Object.freeze(Object.keys(TAURI_KEY_SNIPPETS))
+
+/**
+ * Знаходить усі `<ws>/src-tauri/` каталоги з власним `Cargo.toml` у монорепо.
+ * Обходить workspace-пакети через `getMonorepoPackageRootDirs` (корінь + усі workspaces).
+ * @param {string} cwd корінь проєкту
+ * @returns {Promise<string[]>} абсолютні шляхи до знайдених `src-tauri/` каталогів
+ */
+export async function findSrcTauriDirs(cwd) {
+  const roots = await getMonorepoPackageRootDirs(cwd)
+  const result = []
+  for (const root of roots) {
+    const srcTauriCargo = join(cwd, root, 'src-tauri', 'Cargo.toml')
+    if (existsSync(srcTauriCargo)) {
+      result.push(join(cwd, root, 'src-tauri'))
+    }
+  }
+  return result
+}
+
+/**
+ * Зчитує існуючий `.cargo/mutants.toml` і повертає top-level ключі, яких ще немає.
+ * @param {string} targetPath абсолютний шлях до файла
+ * @returns {Promise<string[]>} список відсутніх канонічних ключів (зі збереженням порядку TAURI_CANONICAL_KEYS)
+ */
+export async function detectMissingKeys(targetPath) {
+  const existing = await readFile(targetPath, 'utf8')
+  const parsed = parseToml(existing)
+  return TAURI_CANONICAL_KEYS.filter(k => !(k in parsed))
+}
+
+/**
+ * Будує append-блок з відсутніх ключів. Існуючий вміст не торкається.
+ * @param {string} existing поточний вміст файла
+ * @param {string[]} missingKeys ключі, які треба додати
+ * @returns {string} новий вміст файла
+ */
+export function buildAppended(existing, missingKeys) {
+  const tail = existing.endsWith('\n') ? existing : `${existing}\n`
+  const block = ['\n# Tauri canonical cargo-mutants additions (tauri.mdc)\n']
+  for (const key of missingKeys) block.push(TAURI_KEY_SNIPPETS[key])
+  return tail + block.join('')
+}
+
+/**
+ * Будує повний Tauri-canonical baseline (для випадку, коли файла ще немає).
+ * @returns {string} вміст для нового `.cargo/mutants.toml`
+ */
+export function buildBaseline() {
+  return TAURI_BASELINE_HEADER + TAURI_CANONICAL_KEYS.map(k => TAURI_KEY_SNIPPETS[k]).join('\n')
+}
+
+/**
+ * Read-only: звітує стан одного `src-tauri/` каталогу — файла немає
+ * (`mutants-config-missing`) або бракує канонічних ключів (`mutants-keys-missing`).
+ * @param {string} srcTauriDir абсолютний шлях до `src-tauri/`
+ * @param {string} cwd корінь проєкту (для relative-шляхів у репортах)
+ * @param {ReturnType<typeof createViolationReporter>} reporter репортер концерну
+ * @returns {Promise<void>}
+ */
+async function reportOneSrcTauri(srcTauriDir, cwd, reporter) {
+  const target = join(srcTauriDir, '.cargo', 'mutants.toml')
+  const rel = relative(cwd, target)
+
+  if (!existsSync(target)) {
+    reporter.fail(
+      `.cargo/mutants.toml відсутній (${rel}) — запусти \`npx @7n/rules lint tauri\` для Tauri canonical baseline (tauri.mdc)`,
+      { reason: MUTANTS_CONFIG_MISSING, file: rel }
+    )
+    return
+  }
+
+  const missing = await detectMissingKeys(target)
+  if (missing.length === 0) {
+    reporter.pass(`.cargo/mutants.toml: manual cargo-mutants config preserved (${rel})`)
+    return
+  }
+
+  reporter.fail(
+    `.cargo/mutants.toml: бракує канонічних Tauri-ключів [${missing.join(', ')}] (${rel}) — запусти \`npx @7n/rules lint tauri\` (tauri.mdc)`,
+    { reason: MUTANTS_KEYS_MISSING, file: rel, data: { missing } }
+  )
+}
+
+/**
+ * @param {import('../../../scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст лінт-прогону.
+ * @returns {Promise<import('../../../scripts/lib/lint-surface/types.mjs').LintResult>} результат перевірки `.cargo/mutants.toml`.
+ */
+export async function lint(ctx) {
+  const cwd = ctx.cwd
+  const reporter = createViolationReporter(ctx)
+  const srcTauriDirs = await findSrcTauriDirs(cwd)
+  if (srcTauriDirs.length === 0) {
+    return reporter.result()
+  }
+  for (const dir of srcTauriDirs) {
+    await reportOneSrcTauri(dir, cwd, reporter)
+  }
+  return reporter.result()
+}

package/rules/tauri/core_test_isolation/concern.json

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

package/rules/tauri/core_test_isolation/core_test_isolation.mdc

@@ -0,0 +1,43 @@
+## Компіляційний цикл: agent/LLM-логіка окремо від app-shell
+
+Якщо Tauri-застосунок говорить з LLM (agent, tool-calling, chat), agent-логіка **не** живе
+у `src-tauri` разом з app-shell — вона винесена в окремий workspace crate (`agent-core` чи
+подібний), який:
+
+- **не залежить від `tauri`** — інакше будь-який `cargo test -p <crate>` все одно тягне повну
+  збірку Tauri runtime;
+- тестується **без** rebuild застосунку: `cargo test -p agent-core`;
+- має **fake/mock реалізацію LLM-провайдера** для інтеграційних тестів — prompt/tool ітерації
+  перевіряються без мережевого виклику до реального провайдера.
+
+**Чому так:** без розділення кожна ітерація промпта чи tool-виклику коштує повний Tauri
+rebuild (лінковка, bundling, іноді webview) замість секундного `cargo test`.
+
+```
+my-tauri-app/
+├── src-tauri/           ← app-shell: Tauri runtime, window/AppHandle, НЕ містить LLM-залежностей
+│   └── Cargo.toml       ← [workspace] members = [".", "../agent-core"]
+└── agent-core/          ← agent/LLM-логіка: prompt building, tool dispatch, provider abstraction
+    ├── Cargo.toml       ← без залежності на tauri
+    └── tests/
+        └── fake_provider.rs   ← FakeLlmProvider / MockLlmClient — без мережі
+```
+
+Концерн `tauri/core_test_isolation.mjs` (read-only detector, `structural`, авто-фікс ризикований)
+для кожного `src-tauri/Cargo.toml` перевіряє:
+
+1. **LLM-залежність не в app-shell.** Якщо сам `src-tauri/Cargo.toml` має залежність на відомий
+   LLM SDK (напр. `async-openai`, `anthropic`, `ollama-rs`, `rig-core`, ...) — фейл: винеси
+   agent-логіку в окремий crate.
+2. **Окремий crate не тягне tauri.** Якщо у `[workspace] members` є crate з LLM-залежністю, і
+   цей crate сам залежить від `tauri`/`tauri-*` — фейл: `cargo test -p` цього крейту все одно
+   перезбирає Tauri runtime.
+3. **Є fake-провайдер.** Якщо такий crate є і не залежить від tauri, але ніде в його дереві
+   (`**/*.rs`) немає маркера `Fake*Llm`/`Mock*Provider`/`Stub*Client` — фейл: інтеграційні тести
+   на prompt/tool ітерації або мовчки пропускають LLM-логіку, або б'ють по реальному провайдеру.
+
+**Область застосування:** концерн активується лише коли у Tauri-воркспейсі є crate з
+LLM-залежністю — Tauri-проєкти без LLM/agent-логіки не порушують це правило.
+
+**Не автофіксується:** виділення crate, перенесення коду і написання fake-провайдера потребують
+людського розсуду — детектор лише репортує з посиланням на це правило.

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

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

package/rules/tauri/core_test_isolation/docs/main.md

@@ -0,0 +1,36 @@
+---
+type: JS Module
+title: main.mjs
+resource: npm/rules/tauri/core_test_isolation/main.mjs
+docgen:
+  crc: f8cf8ea5
+  model: omlx/gemma-4-e4b-it-OptiQ-4bit
+  score: 100
+  issues: best-of-2:retry-won,judge:inaccurate:0.98
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Файл сканує Tauri-проєкти у монорепо, виявляючи порушення ізоляції тестування, пов'язані з LLM-залежностями (позначається константою LLM_DEP_IN_APP_SHELL="llm-dep-in-app-shell") та залежностями від Tauri (позначається константою CORE_CRATE_DEPENDS_ON_TAURI="core-crate-depends-on-tauri"). Мета — ідентифікувати структурні проблеми, що ускладнюють швидкий запуск тестів окремих компонентів без повної збірки застосунку, про що свідчить маркер (core_test_isolation.mdc).
+
+## Поведінка
+
+LLM_DEP_IN_APP_SHELL — Позначає виявлення LLM-залежності всередині основного shell-крейту Tauri, що ускладнює швидкий запуск тестів окремих компонентів.
+CORE_CRATE_DEPENDS_ON_TAURI — Позначає виявлення залежності LLM-крейта від Tauri, що змушує проводити повну збірку застосунку при тестуванні.
+MISSING_FAKE_LLM_PROVIDER — Позначає відсутність фальшивої (mock) реалізації LLM-провайдера у тестуваному крейті, що створює ризик неконтрольованого виконання LLM-логіки.
+lint — Сканує Tauri-проєкти у монорепо для виявлення порушень ізоляції тестування, пов'язаних з залежностями LLM та Tauri, звітуючи про проблеми у форматі (core_test_isolation.mdc).
+
+## Публічний API
+
+* LLM_DEP_IN_APP_SHELL — Надає чіткі причини, чому виникли три класичних порушень, пов'язаних з LLM.
+* CORE_CRATE_DEPENDS_ON_TAURI — Фіксує, що основний компонент залежить від Tauri.
+* MISSING_FAKE_LLM_PROVIDER — Позначає відсутність замінника для моделі штучного інтелекту.
+* lint — Виявляє та виправляє порушення, визначені в системному лінтері.
+
+Поведінка
+Цей код використовує маркери повідомлень, що посилаються на `` для забезпечення ізоляції тестування.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

package/rules/tauri/core_test_isolation/main.mjs

@@ -0,0 +1,166 @@
+/**
+ * @see ./docs/main.md
+ *
+ * Read-only detector: у Tauri-проєктах, що говорять з LLM, agent/provider-логіка
+ * має жити у workspace-крейті окремо від `src-tauri` — без залежності на `tauri`,
+ * щоб `cargo test -p <crate>` ганявся без повної збірки застосунку. Автофікс
+ * ризикований (виділення крейту, перенесення коду) — лише репорт (core_test_isolation.mdc).
+ */
+import { existsSync } from 'node:fs'
+import { glob, readFile } from 'node:fs/promises'
+import { dirname, join, relative, resolve } from 'node:path'
+
+import { parse as parseToml } from 'smol-toml'
+
+import { createViolationReporter } from '../../../scripts/lib/lint-surface/violation-reporter.mjs'
+import { getMonorepoPackageRootDirs } from '../../../scripts/lib/workspaces.mjs'
+
+/** Стабільні reasons для трьох типів порушення. */
+export const LLM_DEP_IN_APP_SHELL = 'llm-dep-in-app-shell'
+export const CORE_CRATE_DEPENDS_ON_TAURI = 'core-crate-depends-on-tauri'
+export const MISSING_FAKE_LLM_PROVIDER = 'missing-fake-llm-provider'
+
+/** Евристичний allowlist назв LLM SDK-крейтів (без версій/scope). */
+const LLM_DEP_RE =
+  /^(async-openai|openai(-api)?|anthropic|claude|genai|llm(-chain)?|ollama-rs|rig-core|langchain|mistralai)/i
+const TAURI_DEP_RE = /^tauri(-|$)/i
+const FAKE_PROVIDER_RE = /\b(Fake|Mock|Stub)\w*(Llm|Provider|Client)\b/
+
+/**
+ * Витягує назви залежностей з розпарсеного Cargo.toml (лише `[dependencies]`).
+ * @param {Record<string, unknown>} parsed розпарсений Cargo.toml
+ * @returns {string[]} назви крейтів-залежностей
+ */
+function dependencyNames(parsed) {
+  const deps = parsed?.dependencies
+  if (!deps || typeof deps !== 'object') return []
+  return Object.keys(deps)
+}
+
+/**
+ * Знаходить усі `src-tauri/` каталоги з власним `Cargo.toml` у монорепо.
+ * @param {string} cwd корінь проєкту
+ * @returns {Promise<string[]>} абсолютні шляхи до `src-tauri/`
+ */
+async function findSrcTauriDirs(cwd) {
+  const roots = await getMonorepoPackageRootDirs(cwd)
+  const result = []
+  for (const root of roots) {
+    const srcTauriCargo = join(cwd, root, 'src-tauri', 'Cargo.toml')
+    if (existsSync(srcTauriCargo)) {
+      result.push(join(cwd, root, 'src-tauri'))
+    }
+  }
+  return result
+}
+
+/**
+ * Резолвить `[workspace] members` (шляхи й прості glob-патерни) відносно `src-tauri/`
+ * у список абсолютних каталогів крейтів, що мають власний Cargo.toml.
+ * @param {string} srcTauriDir абсолютний шлях до `src-tauri/`
+ * @param {string[]} members патерни з `workspace.members`
+ * @returns {Promise<string[]>} абсолютні шляхи членів воркспейсу (без дублікатів)
+ */
+async function resolveWorkspaceMemberDirs(srcTauriDir, members) {
+  const found = new Set()
+  for (const pattern of members) {
+    if (pattern.includes('*')) {
+      for await (const rel of glob(pattern, { cwd: srcTauriDir })) {
+        const abs = resolve(srcTauriDir, rel)
+        if (existsSync(join(abs, 'Cargo.toml'))) found.add(abs)
+      }
+      continue
+    }
+    const abs = resolve(srcTauriDir, pattern)
+    if (existsSync(join(abs, 'Cargo.toml'))) found.add(abs)
+  }
+  return [...found]
+}
+
+/**
+ * Рекурсивно шукає в дереві крейту рядок, що відповідає `FAKE_PROVIDER_RE`
+ * (fake/mock/stub-реалізацію LLM-провайдера, зазвичай у `tests/` чи `src/`).
+ * @param {string} crateDir абсолютний шлях до крейту
+ * @returns {Promise<boolean>} true, якщо знайдено відповідний маркер
+ */
+async function hasFakeLlmProviderMarker(crateDir) {
+  for await (const relPath of glob('**/*.rs', { cwd: crateDir })) {
+    if (relPath.includes('target/')) continue
+    const content = await readFile(join(crateDir, relPath), 'utf8')
+    if (FAKE_PROVIDER_RE.test(content)) return true
+  }
+  return false
+}
+
+/**
+ * Перевіряє один `src-tauri/` каталог: чи LLM-залежність лежить у app-shell крейті,
+ * чи окремий crate з LLM-залежністю сам не тягне `tauri`, чи є fake-провайдер у тестах.
+ * @param {string} srcTauriDir абсолютний шлях до `src-tauri/`
+ * @param {string} cwd корінь проєкту (для relative-шляхів у репортах)
+ * @param {ReturnType<typeof createViolationReporter>} reporter репортер concern-а
+ * @returns {Promise<void>}
+ */
+async function checkOneSrcTauri(srcTauriDir, cwd, reporter) {
+  const cargoPath = join(srcTauriDir, 'Cargo.toml')
+  const parsed = parseToml(await readFile(cargoPath, 'utf8'))
+  const relCargo = relative(cwd, cargoPath)
+
+  const shellDeps = dependencyNames(parsed)
+  if (shellDeps.some(d => LLM_DEP_RE.test(d))) {
+    reporter.fail(
+      `${relCargo}: LLM-провайдер залежність лежить у app-shell крейті src-tauri — кожна ітерація ` +
+        `prompt/tool перезбирає весь Tauri-застосунок. Винеси agent-логіку у окремий workspace crate ` +
+        `(без залежності на tauri) і тестуй \`cargo test -p <crate>\` (core_test_isolation.mdc)`,
+      { reason: LLM_DEP_IN_APP_SHELL, file: relCargo }
+    )
+    return
+  }
+
+  const members = parsed?.workspace?.members
+  if (!Array.isArray(members) || members.length === 0) {
+    return
+  }
+
+  const memberDirs = await resolveWorkspaceMemberDirs(srcTauriDir, members)
+  const otherMemberDirs = memberDirs.filter(d => resolve(d) !== resolve(srcTauriDir))
+
+  for (const memberDir of otherMemberDirs) {
+    const memberCargoPath = join(memberDir, 'Cargo.toml')
+    const memberParsed = parseToml(await readFile(memberCargoPath, 'utf8'))
+    const memberDeps = dependencyNames(memberParsed)
+    if (memberDeps.every(d => !LLM_DEP_RE.test(d))) continue
+
+    const relMemberCargo = relative(cwd, memberCargoPath)
+    if (memberDeps.some(d => TAURI_DEP_RE.test(d))) {
+      reporter.fail(
+        `${relMemberCargo}: agent/LLM crate залежить від tauri — \`cargo test -p\` цього крейту все ` +
+          `одно потягне збірку Tauri runtime. Прибери залежність на tauri з цього крейту (core_test_isolation.mdc)`,
+        { reason: CORE_CRATE_DEPENDS_ON_TAURI, file: relMemberCargo }
+      )
+      continue
+    }
+
+    if (!(await hasFakeLlmProviderMarker(memberDir))) {
+      reporter.fail(
+        `${relMemberCargo}: немає fake/mock LLM-провайдера для інтеграційних тестів — прогін ` +
+          `\`cargo test -p ${dirname(relMemberCargo).split('/').pop()}\` буде або мовчки пропускати ` +
+          `LLM-логіку, або бити по реальному провайдеру. Додай Fake/Mock-реалізацію провайдера в tests/ (core_test_isolation.mdc)`,
+        { reason: MISSING_FAKE_LLM_PROVIDER, file: relMemberCargo }
+      )
+    }
+  }
+}
+
+/**
+ * @param {import('../../../scripts/lib/lint-surface/types.mjs').LintContext} ctx контекст лінт-прогону.
+ * @returns {Promise<import('../../../scripts/lib/lint-surface/types.mjs').LintResult>} результат перевірки.
+ */
+export async function lint(ctx) {
+  const cwd = ctx.cwd
+  const reporter = createViolationReporter(ctx)
+  const srcTauriDirs = await findSrcTauriDirs(cwd)
+  for (const dir of srcTauriDirs) {
+    await checkOneSrcTauri(dir, cwd, reporter)
+  }
+  return reporter.result()
+}

package/rules/tauri/docs/index.md

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

package/rules/tauri/linux_deps/concern.json

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

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

@@ -0,0 +1,29 @@
+---
+type: JS Module
+title: fix-linux_deps.mjs
+resource: npm/rules/tauri/linux_deps/fix-linux_deps.mjs
+docgen:
+  crc: 7d98fa81
+---
+
+## Огляд
+
+T0-autofix концерну `tauri/linux_deps` (tauri.mdc): детерміновано приводить `.github/workflows/lint-rust.yml` до стану з системними залежностями Linux для Tauri. Текстові splice-и (як у `rust/toolchain_cache`) зберігають коментарі та формат файла й дають мінімальний diff.
+
+## Поведінка
+
+- Порушення `missing-linux-deps-step` → вставляє канонічний apt-крок (`sudo apt-get update` + `sudo apt-get install -y` з канонічними пакетами) перед першим кроком `dtolnay/rust-toolchain@…`, на тому самому рівні step-list-а.
+- Якщо toolchain-кроку у файлі немає (нетипове форматування) — нічого не змінює: такий випадок лишається для T1/LLM.
+- Порушення `missing-linux-deps-packages` → дописує відсутні канонічні пакети в кінець наявного `apt-get install`-рядка; trailing `\` shell-continuation зберігається (пакети вставляються перед ним).
+- Ідемпотентно: перед вставкою стан файла заново перевіряється скануванням, повторний прогін не змінює файл.
+
+## Публічний API
+
+- `insertLinuxDepsStep(content)` — новий вміст workflow із канонічним apt-кроком або `null`, якщо крок уже є чи немає anchor-а.
+- `appendMissingPackages(content)` — новий вміст із дописаними відсутніми пакетами або `null`, якщо дописувати нічого.
+- `patterns` — T0-патерни (`tauri-linux-deps-insert`, `tauri-linux-deps-packages`) для центрального fix-pipeline: застосовують трансформери до файлів із відповідних порушень і записують зміни через `ctx.recordWrite`.
+
+## Гарантії поведінки
+
+- Пише лише файли, перелічені у violations; нечитабельні файли мовчки пропускає.
+- Без змін вмісту запис не виконується.

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

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

package/rules/tauri/linux_deps/docs/main.md

@@ -0,0 +1,36 @@
+---
+type: JS Module
+title: main.mjs
+resource: npm/rules/tauri/linux_deps/main.mjs
+docgen:
+  crc: add9f0f3
+---
+
+## Огляд
+
+Read-only detector концерну `tauri/linux_deps` (tauri.mdc). У Tauri-проєкті перевіряє, що `.github/workflows/lint-rust.yml` містить крок встановлення системних залежностей Linux — без них Clippy падає на збірці `-sys`-крейтів (webkit2gtk, gtk, appindicator), чиї build-скрипти шукають системні бібліотеки через pkg-config.
+
+## Поведінка
+
+- Правило активується лише коли хоч у одному workspace-пакеті є `src-tauri/Cargo.toml`; інакше — жодних порушень.
+- Якщо `.github/workflows/lint-rust.yml` відсутній — порушення не звітується: існування файла перевіряє `rust.lint_rust_yml`.
+- Аналіз текстовий (не YAML-AST), як у `rust/toolchain_cache`: шукається перший рядок з `apt-get install`, а канонічні пакети — як substring по всьому файлу (пакет може стояти на continuation-рядку багаторядкового `run: |`).
+- Немає жодного `apt-get install` → порушення `missing-linux-deps-step`.
+- apt-рядок є, але бракує канонічних пакетів → порушення `missing-linux-deps-packages` з переліком відсутніх у `data.missing`.
+- Перевірка — підмножина: додаткові пакети в apt-рядку дозволені.
+
+## Публічний API
+
+- `MISSING_LINUX_DEPS_STEP`, `MISSING_LINUX_DEPS_PACKAGES` — стабільні reason-коди порушень.
+- `LINT_RUST_YML` — шлях цільового workflow-файла.
+- `REQUIRED_LINUX_PACKAGES` — канонічні dev-пакети Tauri v2: `libwebkit2gtk-4.1-dev` (WebView), `libayatana-appindicator3-dev` (tray), `librsvg2-dev` (іконки).
+- `scanLinuxDeps(content)` — сканує вміст workflow: `{ aptLine, missing }` (індекс першого apt-рядка або −1; відсутні канонічні пакети).
+- `lint(ctx)` — стандартна lint-поверхня концерну; повертає результат із порушеннями.
+
+## Де використовується
+
+- Автофікс `fix-linux_deps.mjs` імпортує `scanLinuxDeps`/`REQUIRED_LINUX_PACKAGES` і reason-коди для T0-патернів.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).

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

@@ -0,0 +1,89 @@
+/** @see ./docs/fix-linux_deps.md */
+
+/**
+ * T0-autofix для `tauri/linux_deps` — детерміновано вставляє в
+ * `.github/workflows/lint-rust.yml` канонічний крок системних залежностей Linux
+ * перед `dtolnay/rust-toolchain@…`, або дописує відсутні пакети в уже наявний
+ * `apt-get install`-рядок. Текстові splice-и (як `rust/toolchain_cache`) —
+ * зберігають коментарі/формат, мінімальний diff. Ідемпотентно: `scanLinuxDeps`
+ * заново перевіряє стан файла на кожному прогоні.
+ */
+import { applyToFiles } from '../../../scripts/utils/apply-to-files.mjs'
+
+import {
+  MISSING_LINUX_DEPS_PACKAGES,
+  MISSING_LINUX_DEPS_STEP,
+  REQUIRED_LINUX_PACKAGES,
+  scanLinuxDeps
+} from './main.mjs'
+
+const TOOLCHAIN_RE = /uses:\s*dtolnay\/rust-toolchain@/u
+
+/**
+ * Вставляє канонічний apt-крок перед першим `dtolnay/rust-toolchain@…` кроком
+ * (той самий рівень step-list-а). Якщо apt-крок уже є або toolchain-кроку немає
+ * (нетипове форматування — лишаємо T1/LLM), нічого не змінює.
+ * @param {string} content вміст workflow-файла
+ * @returns {string|null} новий вміст або null, якщо нічого не змінилось
+ */
+export function insertLinuxDepsStep(content) {
+  if (scanLinuxDeps(content).aptLine !== -1) return null
+  const lines = content.split('\n')
+  const at = lines.findIndex(l => TOOLCHAIN_RE.test(l))
+  if (at === -1) return null
+  const usesCol = lines[at].indexOf('uses:')
+  const ind = ' '.repeat(Math.max(usesCol - 2, 0))
+  lines.splice(
+    at,
+    0,
+    `${ind}- name: Системні залежності Tauri (Linux)`,
+    `${ind}  run: |`,
+    `${ind}    sudo apt-get update`,
+    `${ind}    sudo apt-get install -y ${REQUIRED_LINUX_PACKAGES.join(' ')}`,
+    ''
+  )
+  return lines.join('\n')
+}
+
+/**
+ * Дописує відсутні канонічні пакети в кінець наявного `apt-get install`-рядка
+ * (з урахуванням trailing `\` shell-continuation).
+ * @param {string} content вміст workflow-файла
+ * @returns {string|null} новий вміст або null, якщо нічого не змінилось
+ */
+export function appendMissingPackages(content) {
+  const { aptLine, missing } = scanLinuxDeps(content)
+  if (aptLine === -1 || missing.length === 0) return null
+  const lines = content.split('\n')
+  const trimmed = lines[aptLine].trimEnd()
+  lines[aptLine] = trimmed.endsWith('\\')
+    ? `${trimmed.slice(0, -1).trimEnd()} ${missing.join(' ')} \\`
+    : `${trimmed} ${missing.join(' ')}`
+  return lines.join('\n')
+}
+
+/** @type {import('../../../scripts/lib/lint-surface/types.mjs').T0Pattern[]} */
+export const patterns = [
+  {
+    id: 'tauri-linux-deps-insert',
+    test: violations => violations.some(v => v.data?.kind === MISSING_LINUX_DEPS_STEP && v.file),
+    apply: (violations, ctx) => {
+      const targets = violations.filter(v => v.data?.kind === MISSING_LINUX_DEPS_STEP && v.file)
+      const touchedFiles = applyToFiles(targets, ctx, () => insertLinuxDepsStep)
+      return touchedFiles.length > 0
+        ? { touchedFiles, message: `apt-крок системних залежностей Tauri → ${touchedFiles.length} workflow(s)` }
+        : { touchedFiles: [] }
+    }
+  },
+  {
+    id: 'tauri-linux-deps-packages',
+    test: violations => violations.some(v => v.data?.kind === MISSING_LINUX_DEPS_PACKAGES && v.file),
+    apply: (violations, ctx) => {
+      const targets = violations.filter(v => v.data?.kind === MISSING_LINUX_DEPS_PACKAGES && v.file)
+      const touchedFiles = applyToFiles(targets, ctx, () => appendMissingPackages)
+      return touchedFiles.length > 0
+        ? { touchedFiles, message: `канонічні Tauri-пакети → ${touchedFiles.length} workflow(s)` }
+        : { touchedFiles: [] }
+    }
+  }
+]

package/rules/tauri/linux_deps/linux_deps.mdc

@@ -0,0 +1,18 @@
+## Системні залежності Tauri (Linux) у `lint-rust.yml`
+
+Clippy (`cargo clippy --all-targets --all-features`) компілює весь граф залежностей, включно з build-скриптами `-sys`-крейтів (`webkit2gtk-sys`, `gtk-sys`, `libappindicator-sys`). Ці build-скрипти шукають системні `.pc`-файли через pkg-config, тож на `ubuntu-latest` без dev-пакетів крок Clippy падає ще на збірці залежностей. Rustfmt нічого не компілює — вимога стосується саме Clippy.
+
+Правило активується, якщо хоч у одному workspace-пакеті є `src-tauri/Cargo.toml` (Rust-крейт Tauri, який CI компілює). Тоді `.github/workflows/lint-rust.yml` повинен містити крок встановлення системних залежностей:
+
+```yaml
+- name: Системні залежності Tauri (Linux)
+  run: |
+    sudo apt-get update
+    sudo apt-get install -y libwebkit2gtk-4.1-dev libayatana-appindicator3-dev librsvg2-dev
+```
+
+Канонічні пакети (Tauri v2): `libwebkit2gtk-4.1-dev` (WebView), `libayatana-appindicator3-dev` (tray), `librsvg2-dev` (іконки). Перевірка — підмножина: додаткові пакети в `apt-get install` дозволені.
+
+Автофікс (T0): якщо apt-кроку немає — вставляє канонічний блок перед `dtolnay/rust-toolchain@…`; якщо крок є, але бракує пакетів — дописує відсутні в наявний `apt-get install`-рядок.
+
+Існування самого `lint-rust.yml` і решту канону файла перевіряє `rust.lint_rust_yml` (rust.mdc) — тут лише Tauri-специфічний apt-крок. Перевірювана логіка — у `main.mjs`/`fix-linux_deps.mjs` цього концерну.