@nitra/cursor 12.8.5 → 12.8.7

package/rules/security/main.mdc

@@ -5,46 +5,18 @@ alwaysApply: false
 version: '2.1'
 ---
 
-[TruffleHog](https://github.com/trufflesecurity/trufflehog) — глобальний CLI (як `shellcheck`, `conftest`); **не** додавай до `dependencies`/`devDependencies`.
+Правило **security** забезпечує сканування секретів через [TruffleHog](https://github.com/trufflesecurity/trufflehog) локально та на CI, а також правильне використання placeholder-значень у прикладних файлах.
 
-## Канон `package.json`
+[security-trufflehog](./js/trufflehog.mdc)
 
-Скан запускається через `n-cursor lint security` (CI — `n-cursor lint security --read-only`); окремого `lint-*` скрипта в `package.json` немає.
+[security-sample-secret](./js/sample_secret.mdc)
 
-- Заборонено `trufflehog` у `dependencies`/`devDependencies`: [package.json.deny.json](./policy/package_json/template/package.json.deny.json)
+[security-rego-policies](./js/rego_policies.mdc)
 
-**Зауваження:**
+## Швидкий gate через conftest
 
-- `trufflehog filesystem .` — сканує робоче дерево як директорію (включно з untracked/gitignored файлами); підкоманда `git file://.` лишається на CI для аудиту історії.
-- `--no-update` — вимикає self-update check (CI-friendly).
-- `--exclude-paths .trufflehog-exclude` — файл з regex-patterns, які треба пропускати (аналог `[allowlist].paths` із gitleaks).
-- `--results=verified,unknown` — показує лише верифіковані секрети + ті, що TruffleHog не зміг перевірити (`unverified` дублікат відсіюється).
-- `--fail` — exit-code `183` за наявності знахідок (щоб лінт падав).
-
-## `.trufflehog-exclude` (рекомендована основа)
-
-Канон (допускає розширення): [.trufflehog-exclude.snippet.txt](./js/templates/trufflehog/.trufflehog-exclude.snippet.txt)
-
-**Важливо:** один regex-pattern на рядок, без TOML-обгортки; коментарі починаються з `#`.
-
-## CI: `.github/workflows/lint-security.yml`
-
-Workflow обовʼязковий — забезпечує незалежний скан секретів на push/PR (агрегований `lint` локально + окремий fail-fast job на CI).
-
-- Канон: [lint-security.yml.snippet.yml](./policy/lint_security_yml/template/lint-security.yml.snippet.yml)
-
-Перевіряється policy `security.lint_security_yml`: серед `uses:` має бути крок з `trufflesecurity/trufflehog@main`. Універсальні workflow-перевірки (checkout, permissions, persist-credentials) — у `ga.workflow_common`. Для повного скану історії потрібен `fetch-depth: 0`.
-
-## Placeholder для секретів — `sample-secret`
-
-Фейкові credential-значення у **прикладних файлах** (`.env.example`, `.env.dist`, `*.example`, `*.sample`, `*.template`, вміст каталогів `fixtures/`) пиши як `sample-secret`, а не як bare `secret`.
-
-`sample-secret` містить підрядок `sample` із вшитого списку `DefaultFalsePositives` TruffleHog — таке значення сканер відсіює **гарантовано** й незалежно від версії. Bare `secret` наразі не фіксується сканером лише тому, що випадково присутнє у словнику `fp_words.txt`; це крихка поведінка, що залежить від версії інструмента.
-
-- Правильно: `DB_PASSWORD=sample-secret`, `password: "sample-secret"`
-- Неправильно: `DB_PASSWORD=secret`, `password: "secret"`
-
-Перевіряється лише `secret` у позиції значення (після `=`, `:`, `=>`); імена ключів на кшталт `client_secret` не чіпаються. Concern `security.sample_secret` — деталі скану в `js/sample_secret.mjs`.
+- `security.package_json` — забороняє `trufflehog` у `dependencies`/`devDependencies`
+- `security.lint_security_yml` — перевіряє наявність кроку `trufflesecurity/trufflehog@main` у CI workflow
 
 ## Перевірка
 

package/rules/style/js/admin-table.mdc

@@ -0,0 +1,88 @@
+## Адмінські таблиці — n-admin-table
+
+Для таблиць, що мають займати всю висоту сторінки (або блоку), додавай клас `n-admin-table` і атрибути `hide-no-data`, `dense`, `flat`. Таблиця автоматично розтягнеться на весь доступний простір. У блоках меншої висоти — задай їм явний `height`.
+
+```vue
+<!-- ТАБЛИЦЯ -->
+<q-table class="n-admin-table" hide-no-data flat dense />
+```
+
+Якщо клас `.n-admin-table` не визначено в `app.scss` — додай:
+
+```scss
+// ADMIN TABLE
+.n-admin-table {
+  height: calc(100vh - 106px);
+
+  thead {
+    position: sticky;
+    z-index: 3;
+    top: 0;
+
+    tr th {
+      background-color: $grey-3;
+      height: 36px !important;
+    }
+  }
+
+  // tbody td {
+  //   font-size: 14px;
+  // }
+
+  tbody tr:last-child td {
+    border-bottom: 1px solid rgb(0 0 0 / 12%) !important;
+  }
+
+  th:first-child,
+  td:first-child,
+  th:last-child,
+  td:last-child {
+    width: 1px;
+    white-space: nowrap;
+  }
+
+  .q-table__bottom {
+    background-color: $grey-3;
+  }
+
+  .q-table__progress th {
+    height: 1px !important;
+  }
+
+  .text-wrap {
+    max-width: 250px;
+    white-space: normal;
+  }
+
+  // sticky columns
+  td.sticky-left {
+    position: sticky;
+    left: 0;
+    z-index: 2;
+    background-color: white;
+    box-shadow: 2px 0 5px #0002;
+  }
+
+  td.sticky-right {
+    position: sticky;
+    right: 0;
+    z-index: 2;
+    background-color: white;
+    box-shadow: -2px 0 5px #0002;
+  }
+
+  th.sticky-left {
+    position: sticky;
+    left: 0;
+    z-index: 3;
+    box-shadow: 2px 0 5px #0002;
+  }
+
+  th.sticky-right {
+    position: sticky;
+    right: 0;
+    z-index: 3;
+    box-shadow: -2px 0 5px #0002;
+  }
+}
+```

package/rules/style/js/colors.mdc

@@ -0,0 +1,21 @@
+## Кольори: quasar-variables.scss і app.scss
+
+Основні кольори визначай виключно через стандартні Quasar-змінні: `$primary`, `$secondary`, `$accent`, `$positive`, `$negative`, `$warning`.
+
+Якщо потрібен додатковий колір — визнач його в `quasar-variables.scss`, і **обов'язково** додай до `app.scss` відповідні `.text-*` / `.bg-*` класи:
+
+```scss
+/* quasar-variables.scss */
+$white-a1: color.adjust(white, $alpha: -0.85);
+```
+
+```scss
+/* app.scss */
+.text-white-a1 {
+  color: $white-a1 !important;
+}
+
+.bg-white-a1 {
+  background-color: $white-a1 !important;
+}
+```

package/rules/style/js/gap.mdc

@@ -0,0 +1,22 @@
+## Gap між flex/grid-елементами — .n-gap-*
+
+Для відступів між плаваючими елементами (flex, grid) використовуй класи `.n-gap-*` замість `q-gutter-*`. Якщо класів немає в `app.scss` — додай:
+
+```scss
+// GAP
+.n-gap-xs {
+  gap: 4px;
+}
+
+.n-gap-sm {
+  gap: 8px;
+}
+
+.n-gap-md {
+  gap: 16px;
+}
+
+.n-gap-lg {
+  gap: 24px;
+}
+```

package/rules/style/js/quasar-fixes.mdc

@@ -0,0 +1,32 @@
+## Фікси компонентів Quasar
+
+При використанні компонента `q-scroll-area` або `q-tooltip` додай до `app.scss` відповідні фікси. Аналогічно — фікс масштабування на iOS.
+
+```scss
+// FIX стилі для прокручуваної області по висоті екрана
+.q-scrollarea {
+  display: flex;
+  flex-direction: column;
+  height: auto;
+  min-height: 0;
+  max-height: 100%;
+
+  .scroll {
+    flex: 10000 1 0%;
+  }
+}
+
+// FIX tooltip
+.q-tooltip {
+  font-size: 1em;
+}
+
+// FIX не зумувати на iOS
+@media (width <= 600px) {
+  input,
+  textarea,
+  select {
+    font-size: 16px;
+  }
+}
+```

package/rules/style/js/quasar.mdc

@@ -0,0 +1,7 @@
+## Quasar як стильова основа
+
+У Vue-проектах використовуй **Quasar** як базову стильову систему:
+
+- **Класи компонентів:** `q-pa-*`, `q-ma-*`, `q-mt-*`, `q-mb-*`, `row`, `col`, `col-*`, `items-center`, `justify-between`, `text-*`, `bg-*`, `shadow-*` тощо — стандартні утиліти Quasar.
+- **Кольори:** використовуй Quasar CSS-змінні через класи (`text-primary`, `bg-accent`, `text-negative` тощо) або через SCSS-змінні (`$primary`, `$accent`) у `.scss`-файлах.
+- **Не пиши власні утиліти**, якщо є відповідний Quasar-клас.

package/rules/style/js/tooling.mdc

@@ -0,0 +1,85 @@
+## Генерація та редагування стилів (Cursor і інші агенти)
+
+- **Джерело правил:** перед тим як писати або суттєво змінювати **`.css`**, **`.scss`** або стилі в **`.vue`**, переглянь у корені проєкту (і в релевантних пакетах монорепо, якщо є) поле **`stylelint`** у **`package.json`** (зокрема `extends`), наявні **`.stylelintrc.*`**, **`stylelint.config.*`** та **`.stylelintignore`**. Не покладайся на «типові» правила stylelint з пам'яті — дотримуйся **проєктного** **`@nitra/stylelint-config`** і будь-яких локальних доповнень у репозиторії.
+- **Форматування** узгоджуй з **`n-text.mdc`** (oxfmt / `.oxfmtrc.json` для css, scss тощо), щоб форматер і stylelint не суперечили один одному.
+- **Запуск stylelint:** лише через **`n-cursor lint style`** (локально — з auto-fix; у CI — `--read-only`, нуль мутацій). Під капотом — `npx stylelint`; **не** використовуй **`bunx stylelint`**. Після змін запускай **`n-cursor lint style`** і виправляй усе, що лишилось після auto-fix; за потреби — повний прогін `n-cursor lint --full`.
+- **Не розширюй винятки:** не додавай зайві **`stylelint-disable`** без потреби; краще підлаштувати стилі під правила проєкту.
+
+## Канон налаштувань
+
+### `package.json`
+
+- `stylelint.extends`: [package.json.snippet.json](./policy/package_json/template/package.json.snippet.json)
+
+Окремого `lint-style` скрипта немає — запуск через **`n-cursor lint style`** (CI — `--read-only`).
+
+```json title="package.json"
+  "devDependencies": {
+    "@nitra/stylelint-config": "^1.4.0"
+  },
+  "stylelint": {
+    "extends": "@nitra/stylelint-config"
+  },
+```
+
+У корені проєкту має бути **`.stylelintignore`**:
+
+```text title=".stylelintignore"
+dist/
+```
+
+### `.vscode/extensions.json`
+
+- Канон `recommendations`: [extensions.json.snippet.json](./policy/vscode_extensions/template/extensions.json.snippet.json)
+
+### `.vscode/settings.json`
+
+- Вимкнення вбудованої CSS-валідації VS Code: [settings.json.snippet.json](./policy/vscode_settings/template/settings.json.snippet.json)
+
+### CI: `.github/workflows/lint-style.yml`
+
+- Канон: [lint-style.yml.snippet.yml](./policy/lint_style_yml/template/lint-style.yml.snippet.yml)
+
+Додай **`.github/workflows/lint-style.yml`** (лише **`.yml`**, **`ga.mdc`**): після **`checkout`** — локальний composite **`setup-bun-deps`**, далі `n-cursor lint style --read-only` у кроці **`run`**. **Не** дублюй окремі кроки **`setup-node`** / **`oven-sh/setup-bun`** / кеш / **`npm install`**.
+
+```yaml title=".github/workflows/lint-style.yml"
+name: StyleLint
+
+on:
+  push:
+    branches:
+      - dev
+      - main
+    paths:
+      - '**/*.css'
+      - '**/*.scss'
+      - '**/*.vue'
+
+  pull_request:
+    branches:
+      - dev
+      - main
+    paths:
+      - '**/*.css'
+      - '**/*.scss'
+      - '**/*.vue'
+
+concurrency:
+  group: ${{ github.ref }}-${{ github.workflow }}
+  cancel-in-progress: true
+
+jobs:
+  stylelint:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          persist-credentials: false
+
+      - uses: ./.github/actions/setup-bun-deps
+
+      - name: StyleLint
+        run: npx stylelint '**/*.{css,scss,vue}'
+```

package/rules/style/main.mdc

@@ -5,265 +5,25 @@ globs: "**/*.{css,scss,vue}"
 alwaysApply: false
 ---
 
-## Quasar як стильова основа
+Правило **style** для Vue-проєктів: Quasar як стильова система, SCSS-конвенції кольорів і відступів, фікси компонентів, stylelint через `@nitra/stylelint-config`.
 
-У Vue-проектах використовуй **Quasar** як базову стильову систему:
+[style-quasar](./js/quasar.mdc)
 
-- **Класи компонентів:** `q-pa-*`, `q-ma-*`, `q-mt-*`, `q-mb-*`, `row`, `col`, `col-*`, `items-center`, `justify-between`, `text-*`, `bg-*`, `shadow-*` тощо — стандартні утиліти Quasar.
-- **Кольори:** використовуй Quasar CSS-змінні через класи (`text-primary`, `bg-accent`, `text-negative` тощо) або через SCSS-змінні (`$primary`, `$accent`) у `.scss`-файлах.
-- **Не пиши власні утиліти**, якщо є відповідний Quasar-клас.
+[style-colors](./js/colors.mdc)
 
-## Кольори: quasar-variables.scss і app.scss
+[style-gap](./js/gap.mdc)
 
-Основні кольори визначай виключно через стандартні Quasar-змінні: `$primary`, `$secondary`, `$accent`, `$positive`, `$negative`, `$warning`.
+[style-quasar-fixes](./js/quasar-fixes.mdc)
 
-Якщо потрібен додатковий колір — визнач його в `quasar-variables.scss`, і **обов'язково** додай до `app.scss` відповідні `.text-*` / `.bg-*` класи:
+[style-tooling](./js/tooling.mdc)
 
-```scss
-/* quasar-variables.scss */
-$white-a1: color.adjust(white, $alpha: -0.85);
-```
+[style-admin-table](./js/admin-table.mdc)
 
-```scss
-/* app.scss */
-.text-white-a1 {
-  color: $white-a1 !important;
-}
+## Швидкий gate через conftest (Rego)
 
-.bg-white-a1 {
-  background-color: $white-a1 !important;
-}
-```
+Пакети у `npm/rules/style/policy/`:
 
-## Gap між flex/grid-елементами — .n-gap-*
-
-Для відступів між плаваючими елементами (flex, grid) використовуй класи `.n-gap-*` замість `q-gutter-*`. Якщо класів немає в `app.scss` — додай:
-
-```scss
-// GAP
-.n-gap-xs {
-  gap: 4px;
-}
-
-.n-gap-sm {
-  gap: 8px;
-}
-
-.n-gap-md {
-  gap: 16px;
-}
-
-.n-gap-lg {
-  gap: 24px;
-}
-```
-
-## Фікси компонентів Quasar
-
-При використанні компонента `q-scroll-area` або `q-tooltip` додай до `app.scss` відповідні фікси. Аналогічно — фікс масштабування на iOS.
-
-```scss
-// FIX стилі для прокручуваної області по висоті екрана
-.q-scrollarea {
-  display: flex;
-  flex-direction: column;
-  height: auto;
-  min-height: 0;
-  max-height: 100%;
-
-  .scroll {
-    flex: 10000 1 0%;
-  }
-}
-
-// FIX tooltip
-.q-tooltip {
-  font-size: 1em;
-}
-
-// FIX не зумувати на iOS
-@media (width <= 600px) {
-  input,
-  textarea,
-  select {
-    font-size: 16px;
-  }
-}
-```
-
-## Генерація та редагування стилів (Cursor і інші агенти)
-
-- **Джерело правил:** перед тим як писати або суттєво змінювати **`.css`**, **`.scss`** або стилі в **`.vue`**, переглянь у корені проєкту (і в релевантних пакетах монорепо, якщо є) поле **`stylelint`** у **`package.json`** (зокрема `extends`), наявні **`.stylelintrc.*`**, **`stylelint.config.*`** та **`.stylelintignore`**. Не покладайся на «типові» правила stylelint з пам’яті — дотримуйся **проєктного** **`@nitra/stylelint-config`** і будь-яких локальних доповнень у репозиторії.
-- **Форматування** узгоджуй з **`n-text.mdc`** (oxfmt / `.oxfmtrc.json` для css, scss тощо), щоб форматер і stylelint не суперечили один одному.
-- **Запуск stylelint:** лише через **`n-cursor lint style`** (локально — з auto-fix; у CI — `--read-only`, нуль мутацій). Під капотом — `npx stylelint`; **не** використовуй **`bunx stylelint`**. Після змін запускай **`n-cursor lint style`** і виправляй усе, що лишилось після auto-fix; за потреби — повний прогін `n-cursor lint --full`.
-- **Не розширюй винятки:** не додавай зайві **`stylelint-disable`** без потреби; краще підлаштувати стилі під правила проєкту.
-
-## Канон
-
-### `package.json`
-
-- `stylelint.extends`: [package.json.snippet.json](./policy/package_json/template/package.json.snippet.json)
-
-Окремого `lint-style` скрипта немає — запуск через **`n-cursor lint style`** (CI — `--read-only`).
-
-### `.vscode/extensions.json`
-
-- Канон `recommendations`: [extensions.json.snippet.json](./policy/vscode_extensions/template/extensions.json.snippet.json)
-
-### `.vscode/settings.json`
-
-- Вимкнення вбудованої CSS-валідації VS Code: [settings.json.snippet.json](./policy/vscode_settings/template/settings.json.snippet.json)
-
-### CI: `.github/workflows/lint-style.yml`
-
-- Канон: [lint-style.yml.snippet.yml](./policy/lint_style_yml/template/lint-style.yml.snippet.yml)
-
-**`package.json`:**
-
-```json title="package.json"
-  "devDependencies": {
-    "@nitra/stylelint-config": "^1.4.0"
-  },
-  "stylelint": {
-    "extends": "@nitra/stylelint-config"
-  },
-```
-
-Додай **`.github/workflows/lint-style.yml`** (лише **`.yml`**, **`ga.mdc`**): після **`checkout`** — локальний composite **`setup-bun-deps`**, далі `n-cursor lint style --read-only` у кроці **`run`**. **Не** дублюй окремі кроки **`setup-node`** / **`oven-sh/setup-bun`** / кеш / **`npm install`**.
-
-```yaml title=".github/workflows/lint-style.yml"
-name: StyleLint
-
-on:
-  push:
-    branches:
-      - dev
-      - main
-    paths:
-      - '**/*.css'
-      - '**/*.scss'
-      - '**/*.vue'
-
-  pull_request:
-    branches:
-      - dev
-      - main
-    paths:
-      - '**/*.css'
-      - '**/*.scss'
-      - '**/*.vue'
-
-concurrency:
-  group: ${{ github.ref }}-${{ github.workflow }}
-  cancel-in-progress: true
-
-jobs:
-  stylelint:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-    steps:
-      - uses: actions/checkout@v6
-        with:
-          persist-credentials: false
-
-      - uses: ./.github/actions/setup-bun-deps
-
-      - name: StyleLint
-        run: npx stylelint '**/*.{css,scss,vue}'
-```
-
-У корені проєкту має бути **`.stylelintignore`**:
-
-```text title=".stylelintignore"
-dist/
-```
-
-## Адмінські таблиці — n-admin-table
-
-Для таблиць, що мають займати всю висоту сторінки (або блоку), додавай клас `n-admin-table` і атрибути `hide-no-data`, `dense`, `flat`. Таблиця автоматично розтягнеться на весь доступний простір. У блоках меншої висоти — задай їм явний `height`.
-
-```vue
-<!-- ТАБЛИЦЯ -->
-<q-table class="n-admin-table" hide-no-data flat dense />
-```
-
-Якщо клас `.n-admin-table` не визначено в `app.scss` — додай:
-
-```scss
-// ADMIN TABLE
-.n-admin-table {
-  height: calc(100vh - 106px);
-
-  thead {
-    position: sticky;
-    z-index: 3;
-    top: 0;
-
-    tr th {
-      background-color: $grey-3;
-      height: 36px !important;
-    }
-  }
-
-  // tbody td {
-  //   font-size: 14px;
-  // }
-
-  tbody tr:last-child td {
-    border-bottom: 1px solid rgb(0 0 0 / 12%) !important;
-  }
-
-  th:first-child,
-  td:first-child,
-  th:last-child,
-  td:last-child {
-    width: 1px;
-    white-space: nowrap;
-  }
-
-  .q-table__bottom {
-    background-color: $grey-3;
-  }
-
-  .q-table__progress th {
-    height: 1px !important;
-  }
-
-  .text-wrap {
-    max-width: 250px;
-    white-space: normal;
-  }
-
-  // sticky columns
-  td.sticky-left {
-    position: sticky;
-    left: 0;
-    z-index: 2;
-    background-color: white;
-    box-shadow: 2px 0 5px #0002;
-  }
-
-  td.sticky-right {
-    position: sticky;
-    right: 0;
-    z-index: 2;
-    background-color: white;
-    box-shadow: -2px 0 5px #0002;
-  }
-
-  th.sticky-left {
-    position: sticky;
-    left: 0;
-    z-index: 3;
-    box-shadow: 2px 0 5px #0002;
-  }
-
-  th.sticky-right {
-    position: sticky;
-    right: 0;
-    z-index: 3;
-    box-shadow: -2px 0 5px #0002;
-  }
-}
-```
+- `style_lint.package_json` — `package.json`: `stylelint.extends == "@nitra/stylelint-config"`, `@nitra/stylelint-config` у `devDependencies`.
+- `style_lint.vscode_extensions` — `.vscode/extensions.json`: `recommendations` містить `stylelint.vscode-stylelint`.
+- `style_lint.vscode_settings` — `.vscode/settings.json`: `css.validate`, `less.validate`, `scss.validate` вимкнені (`false`).
+- `style_lint.lint_style_yml` — `.github/workflows/lint-style.yml`: крок `run` містить команду `n-cursor lint style --read-only`.

package/rules/tauri/js/cargo_mutants_config.mdc

@@ -0,0 +1,39 @@
+## Mutation-testing: семантика app shell та platform bridge
+
+`tauri` rule володіє Tauri-specific семантикою mutation-testing для каталога `src-tauri/`. Концерн `js/cargo_mutants_config.mjs` без дублювання додає у `<ws>/src-tauri/.cargo/mutants.toml` такі канонічні ключі:
+
+```toml title="<ws>/src-tauri/.cargo/mutants.toml"
+additional_cargo_test_args = ["--lib", "--tests"]
+
+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"
+]
+```
+
+Семантика (фіксована між Tauri-проєктами):
+
+- **`src/main.rs`** — binary shell entrypoint: запускає Tauri runtime, реєструє plugins/handlers і повертає управління циклу подій. Тестується smoke/e2e (запуск бінарника), не mutation unit;
+- **`src/lib.rs`** — Tauri runtime entrypoint (`pub fn run`): піднімає весь app shell. Один мутант там тримає весь Tauri runtime, тому ділить sandbox-фейл з `src/main.rs` і тестується smoke/e2e, а не mutation unit;
+- **`*android.rs`, `*ios.rs`, `*mobile.rs`** — mobile plugin bridge / platform glue: тонка обгортка над JNI/Objective-C виклики, mapping platform errors, виклики Tauri AppHandle і native API;
+- **`*macos.rs`, `*windows.rs`, `*linux.rs`, `*desktop.rs`** — desktop platform bridge / OS integration glue: opener/window APIs, OS-specific I/O, mapping platform errors.
+
+Ці файли мають містити **тільки platform boundary**: виклик plugin/native API, Tauri AppHandle, opener/window APIs, OS-specific I/O, mapping platform errors. Якщо у bridge-файлі з'являється pure/business logic — її потрібно винести у platform-neutral модуль (`src/auth/oauth.rs`, `src/gmail/message.rs`, …) і тестувати mutation-testing там.
+
+Це створює фіксовану семантику: `*android.rs`/`*macos.rs` — boundary-файли, а не місце для бізнес-логіки.
+
+### Ідемпотентність і взаємодія з `test`-rule
+
+- `test` rule створює універсальний нейтральний `.cargo/mutants.toml` (порожній з коментарем) для кожного Cargo.toml-manifest-файла — без framework-specific exclude'ів. Це наш baseline.
+- `tauri` rule додає Tauri-канонічні ключі **поверх** того, що вже є у `<ws>/src-tauri/.cargo/mutants.toml`:
+  - якщо файла немає — створює з повного Tauri-baseline;
+  - якщо обидва канонічні ключі (`additional_cargo_test_args`, `exclude_globs`) вже присутні — `manual cargo-mutants config preserved`, нічого не зміниться;
+  - якщо якийсь канонічний ключ відсутній — додається окремим блоком у кінці файла, без зміни існуючих значень.
+- Послідовний `fix test` → `fix tauri` створює Tauri-config; повторний `fix tauri` не дублює секцій; повторний `fix test` не перетирає Tauri-tuning.

package/rules/tauri/js/tool_surface.mdc

@@ -0,0 +1,21 @@
+## Tool Surface у Tauri (реалізація ядра `tool-surface`)
+
+Це per-stack реалізація правила **`tool-surface`** (`n-tool-surface`) для Tauri+Rust. Контракт (каталог → `dispatch` → UI/оркестратор/LLM, інваріант паритету, конверт) — у тому правилі; тут — як він лягає на Tauri.
+
+**Реальна робота живе в Rust, JS-каталог — тонкий call surface.** Handler тула не містить логіки сам — він **делегує** в native. Одна реалізація в Rust-крейті backs два споживачі:
+
+- **Бінарник** (`src-tauri` як CLI, або окремий crate-bin) — headless-вхід для оркестратора;
+- **Tauri-команда** (`#[tauri::command]`) — той самий крейт-fn, обгорнутий для UI.
+
+**Два транспорти одного каталогу** (`src/tool/transports`):
+
+- **UI (in-app):** `invoke(tool.tauri, input)` → Tauri-команда → крейт. Ключі `input` мапляться 1:1 на аргументи команди (camelCase, напр. `tasksDir`); поля вкладених struct лишаються snake_case (Tauri конвертить лише імена top-level аргументів).
+- **Оркестратор (headless):** `bin/<app>.mjs` спавнить зібраний бінарник (`<bin> <verb> …` per-verb, або уніфікований `<bin> exec '<json>'`), парсить JSON stdout.
+
+**Конверт:** Tauri-команда повертає `Result<T, String>`; адаптер мапить у `{ ok, output }` / `{ ok:false, error }`. Бінарник друкує конверт у stdout, exit ≠ 0 на `ok:false`.
+
+**Єдине джерело схем:** надавай перевагу `schemars`-derive на Rust-param-структурах → бінарник віддає маніфест (`<bin> schema`); або тримай схему в JS-каталозі й валідуй до `invoke`. **Не дублюй** контракт між Rust і JS — лише деривація + спільні тест-вектори.
+
+**Дозволи:** будь-який плагін, який смикають тули (`tauri-plugin-dialog`, `tauri-plugin-http` для локальної LLM тощо), має бути в `src-tauri/capabilities/*.json` і зареєстрований у `lib.rs` — інакше виклик тихо падає.
+
+**LLM-раннер in-app:** chat-loop ходить до OpenAI-сумісного ендпоінта через `tauri-plugin-http` fetch (бо webview-fetch обмежений CSP/capability), а тули виконує через спільний `dispatch` (той самий, що й UI).