@7n/rules 1.37.0 → 1.38.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [1.38.0] - 2026-07-21
+
+### Fixed
+
+- tauri/gitignore_target, tauri/core_test_isolation: інваріант workspace-кореня замість хибної typo-версії
+
 ## [1.37.0] - 2026-07-21
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@7n/rules",
-  "version": "1.37.0",
+  "version": "1.38.0",
   "description": "CLI еталонних правил і skills (префікс n-): синк у репозиторій, дельта-lint, конформність",
   "keywords": [
     "cli",

package/rules/tauri/core_test_isolation/core_test_isolation.mdc

@@ -15,23 +15,37 @@ rebuild (лінковка, bundling, іноді webview) замість секу
 
 ```
 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
+├── Cargo.toml            ← workspace root (virtual, без [package]): [workspace] members = ["src-tauri", "agent-core"]
+├── src-tauri/            ← app-shell: Tauri runtime, window/AppHandle, НЕ містить LLM-залежностей
+│   └── Cargo.toml        ← [package], без [workspace] — сам по собі НЕ workspace root
+└── agent-core/           ← agent/LLM-логіка: prompt building, tool dispatch, provider abstraction
+    ├── Cargo.toml        ← без залежності на tauri
     └── tests/
         └── fake_provider.rs   ← FakeLlmProvider / MockLlmClient — без мережі
 ```
 
+`[workspace] members = [".", "../agent-core"]` **всередині** `src-tauri/Cargo.toml` — невалідний
+Cargo layout: `../agent-core` лежить поза деревом workspace root (`src-tauri/`), і Cargo відмовляє
+з `workspace member '.../agent-core/Cargo.toml' is not hierarchically below the workspace root`.
+Тому `[workspace]` живе у product-root `Cargo.toml`, що лежить НАД обома крейтами (канон
+`rust/workspace_root.mdc` — один кореневий Cargo workspace на репозиторій).
+
+**Наслідок:** `target/` компілюється у корінь цього workspace (`my-tauri-app/target/`), а не в
+`src-tauri/target/` — це впливає на очікуваний запис у `.gitignore` (`tauri/gitignore_target`) і на
+шлях у `workspaces:`-полі `Swatinem/rust-cache` GitHub Action (action бере шлях буквально як
+`<path>/target`, тож там має стояти корінь цього workspace, не `src-tauri`).
+
 Концерн `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.
+2. **Окремий crate не тягне tauri.** `[workspace] members` резолвиться або з самого
+   `src-tauri/Cargo.toml` (standalone-патерн), або — коли там `[workspace]` немає — з
+   найближчого предка-workspace root (product-root `Cargo.toml` над `src-tauri/`). Якщо серед
+   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-логіку, або б'ють по реальному провайдеру.

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

@@ -3,7 +3,7 @@ type: JS Module
 title: main.mjs
 resource: npm/rules/tauri/core_test_isolation/main.mjs
 docgen:
-  crc: cfb870f5
+  crc: 2fe501fb
   model: omlx/gemma-4-e4b-it-OptiQ-4bit
   score: 100
   issues: best-of-2:retry-won,judge:inaccurate:0.98

package/rules/tauri/core_test_isolation/main.mjs

@@ -14,6 +14,7 @@ import { parse as parseToml } from 'smol-toml'
 
 import { scanGlob } from '../../../scripts/utils/glob-compat.mjs'
 import { createViolationReporter } from '../../../scripts/lib/lint-surface/violation-reporter.mjs'
+import { findAncestorWorkspaceRoot, resolveWorkspaceMemberDirs } from '../../../scripts/utils/cargo-workspace.mjs'
 import { getMonorepoPackageRootDirs } from '../../../scripts/lib/workspaces.mjs'
 
 /** Стабільні reasons для трьох типів порушення. */
@@ -55,29 +56,6 @@ async function findSrcTauriDirs(cwd) {
   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 scanGlob(pattern, 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/`).
@@ -117,12 +95,19 @@ async function checkOneSrcTauri(srcTauriDir, cwd, reporter) {
     return
   }
 
-  const members = parsed?.workspace?.members
-  if (!Array.isArray(members) || members.length === 0) {
-    return
+  // `[workspace]` живе або у самому src-tauri/Cargo.toml (старий/standalone патерн), або —
+  // канонічно (rust/workspace_root.mdc) — у предку-workspace root над src-tauri/.
+  let workspaceRootDir = srcTauriDir
+  let members = Array.isArray(parsed?.workspace?.members) ? parsed.workspace.members : []
+  if (members.length === 0) {
+    const ancestor = await findAncestorWorkspaceRoot(srcTauriDir, cwd)
+    const ancestorMembers = ancestor?.parsed?.workspace?.members
+    if (!ancestor || !Array.isArray(ancestorMembers) || ancestorMembers.length === 0) return
+    workspaceRootDir = ancestor.rootDir
+    members = ancestorMembers
   }
 
-  const memberDirs = await resolveWorkspaceMemberDirs(srcTauriDir, members)
+  const memberDirs = await resolveWorkspaceMemberDirs(workspaceRootDir, members)
   const otherMemberDirs = memberDirs.filter(d => resolve(d) !== resolve(srcTauriDir))
 
   for (const memberDir of otherMemberDirs) {

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

@@ -3,9 +3,8 @@ type: JS Module
 title: main.mjs
 resource: npm/rules/tauri/gitignore_target/main.mjs
 docgen:
-  crc: 83aa81ee
+  crc: c9fcfc58
   model: openai-codex/gpt-5.5
-  tier: cloud-avg
   score: 85
   issues: internal-name:findSrcTauriDirs,anchor-miss:(tauri.mdc),judge:inaccurate:0.98
   judgeModel: openai-codex/gpt-5.4-mini

package/rules/tauri/gitignore_target/gitignore_target.mdc

@@ -1,23 +1,42 @@
-## `.gitignore`: ignore build-артефактів `<ws>/src-tauri/target/`
+## `.gitignore`: ignore build-артефактів фактичного Cargo workspace root
 
-Кожен `<ws>/src-tauri/` (Rust-крейт Tauri) компілюється в `<ws>/src-tauri/target/` — build-артефакти Cargo (сотні MB, десятки тисяч файлів). Корінний `.gitignore` монорепо повинен містити точний ignore-запис для кожного такого воркспейсу:
+Кожен `<ws>/src-tauri/` (Rust-крейт Tauri) компілюється в `target/` свого фактичного
+Cargo workspace root — а не завжди в `<ws>/src-tauri/target/`. Якщо над `src-tauri/` є
+предок-workspace (канон `rust/workspace_root.mdc` — один кореневий Cargo workspace на
+репозиторій, наприклад `<ws>/Cargo.toml` чи кореневий `Cargo.toml` монорепо), Cargo кладе
+`target/` саме туди. Корінний `.gitignore` монорепо повинен містити точний ignore-запис
+для кожного такого крейту, обчислений від цього фактичного workspace root:
 
 ```gitignore
 # Tauri — Rust build artifacts (tauri.mdc)
-<ws>/src-tauri/target/
+<workspace-root>/target/
 ```
 
+де `<workspace-root>` — найближчий предок `src-tauri/` з `[workspace]`, чиї `members`
+покривають цей крейт (якщо це корінь монорепо — запис голий `target/`); якщо предка-workspace
+немає — крейт сам собі workspace root, і запис лишається `<ws>/src-tauri/target/`.
+
 ### Чому точний шлях, а не голий `target/`
 
-Реальний інцидент: у `nitra/task` корінний `.gitignore` мав `owner/target/` замість `owner/src-tauri/target/` — воркспейс скопійований з іншого проєкту без заміни шляху (typo). `target/` там ігнорувався не там, де компілятор його реально створює, тож ~600MB / ~28k файлів build-артефактів не потрапляли під жоден ignore-патерн і мало не потрапили в коміт через `git add -A`.
+Реальний прецедент: у `nitra/task` коміт `3cb0df3` помилково "виправив" коректний запис
+`owner/target/` назад на `owner/src-tauri/target/` — автор вважав це друкарською помилкою,
+не врахувавши, що `owner/Cargo.toml` є Cargo workspace root для `owner/src-tauri` і тому
+`target/` справді компілюється в `owner/target/`, а не в `owner/src-tauri/target/`. Коміт
+`ac3451e` це скасував. Тобто `<ws>/src-tauri/target/` — не універсальний дефолт, а лише
+окремий випадок (crate без workspace root над собою); перевірка мусить рахувати очікуваний
+шлях від реального workspace root, а не від фіксованого суфікса.
 
-Тому перевірка звіряє **точний рядок** `<ws>/src-tauri/target/` для кожного знайденого `src-tauri/`, а не факт наявності підрядка `target/` десь у файлі — голий `target/` (чи вже наявний, але помилковий `owner/target/`) не закриває violation.
+Тому перевірка звіряє **точний рядок** обчисленого запису для кожного знайденого `src-tauri/`,
+а не факт наявності підрядка `target/` десь у файлі — голий `target/` чи запис не того рівня
+не закривають violation. Сторонній/мертвий каталог `target/` на диску (за старим, вже
+невірним шляхом) також не задовольняє перевірку — вона звіряє лише вміст `.gitignore`.
 
 ### Область дії
 
 - Обхід усіх `<ws>/src-tauri/` — спільний з `tauri/cargo_mutants_config` (`findSrcTauriDirs`, без дублювання обходу монорепо).
+- Очікуваний шлях — `findAncestorWorkspaceRoot` (`scripts/utils/cargo-workspace.mjs`, спільно з `rust/workspace_root`).
 - Ціль фіксу — **один** корінний `.gitignore` монорепо (не по workspace).
-- Детектор лише **додає** відсутнє: сторонні/застарілі ignore-записи (на кшталт помилкового `owner/target/` з інциденту вище) не видаляються — вони можуть бути навмисними чи потребувати ручного review.
+- Детектор лише **додає** відсутнє: сторонні/застарілі ignore-записи не видаляються — вони можуть бути навмисними чи потребувати ручного review.
 
 ### Автофікс (T0)
 

package/rules/tauri/gitignore_target/main.mjs

@@ -2,15 +2,19 @@
  * @see ./docs/main.md
  *
  * Read-only detector: для кожного знайденого `<ws>/src-tauri/` у монорепо
- * корінний `.gitignore` повинен містити точний ignore-запис
- * `<ws>/src-tauri/target/` (tauri.mdc).
+ * корінний `.gitignore` повинен містити точний ignore-запис для build-артефактів
+ * — але шлях залежить від фактичного Cargo workspace root крейту, не від
+ * розташування самого `src-tauri/` (tauri.mdc).
  *
- * Реальний інцидент: у `nitra/task` `.gitignore` мав `owner/target/` замість
- * `owner/src-tauri/target/` (typo — воркспейс скопійований без заміни шляху),
- * тому build-артефакти (~600MB, ~28k файлів) не ігнорувались і мало не
- * потрапили в коміт через `git add -A`. Тому перевірка — точний match рядка
- * повного шляху, не пошук голого `target/` десь у файлі: голий `target/`
- * (чи `owner/target/`) дав би false negative саме на цьому кейсі.
+ * Крейт `src-tauri/` компілюється в `<workspace-root>/target/`, а не обов'язково
+ * в `<ws>/src-tauri/target/`: коли над `src-tauri/` є предок-workspace (канон
+ * `rust/workspace_root` — один кореневий Cargo workspace на репозиторій), Cargo
+ * кладе `target/` саме туди. Реальний прецедент: у `nitra/task` коміт `3cb0df3`
+ * помилково "виправив" коректний запис `owner/target/` назад на `owner/src-tauri/target/`
+ * (бо `owner/Cargo.toml` — workspace root для `owner/src-tauri`), що скасував наступний
+ * коміт `ac3451e`. Тому перевірка обчислює очікуваний шлях від реального workspace root,
+ * а не від фіксованого суфікса `src-tauri/target/`, і звіряє точний рядок — голий
+ * `target/` чи запис не-того рівня не рахуються присутністю потрібного запису.
  *
  * Обхід `<ws>/src-tauri/` — спільний з `tauri/cargo_mutants_config`
  * (`findSrcTauriDirs`), без дублювання.
@@ -20,6 +24,7 @@ import { readFile } from 'node:fs/promises'
 import { join, relative } from 'node:path'
 
 import { createViolationReporter } from '../../../scripts/lib/lint-surface/violation-reporter.mjs'
+import { findAncestorWorkspaceRoot } from '../../../scripts/utils/cargo-workspace.mjs'
 import { findSrcTauriDirs } from '../cargo_mutants_config/main.mjs'
 
 /** Стабільний reason: у корінному `.gitignore` бракує ignore-запису(ів) для `src-tauri/target/`. */
@@ -29,13 +34,22 @@ export const MISSING_GITIGNORE_TARGET_ENTRIES = 'missing-gitignore-target-entrie
 export const ROOT_GITIGNORE = '.gitignore'
 
 /**
- * Очікуваний ignore-запис для build-артефактів одного `<ws>/src-tauri/`.
+ * Очікуваний ignore-запис для build-артефактів одного `<ws>/src-tauri/`: шлях до
+ * `target/` фактичного Cargo workspace root цього крейту (найближчий предок з
+ * `[workspace]`, чиї `members` покривають `src-tauri/`), а не суфікс `src-tauri/target/`
+ * за замовчуванням. Якщо предка-workspace немає — крейт сам собі workspace root
+ * (standalone `src-tauri/Cargo.toml`), і `target/` лишається під `src-tauri/`.
  * @param {string} cwd корінь монорепо
  * @param {string} srcTauriDir абсолютний шлях до `src-tauri/`
- * @returns {string} очікуваний рядок у корінному `.gitignore` (`<ws>/src-tauri/target/`)
+ * @returns {Promise<string>} очікуваний рядок у корінному `.gitignore`
  */
-export function expectedTargetEntry(cwd, srcTauriDir) {
-  return `${relative(cwd, srcTauriDir)}/target/`
+export async function expectedTargetEntry(cwd, srcTauriDir) {
+  const ancestor = await findAncestorWorkspaceRoot(srcTauriDir, cwd)
+  if (!ancestor) {
+    return `${relative(cwd, srcTauriDir)}/target/`
+  }
+  const relRoot = relative(cwd, ancestor.rootDir)
+  return relRoot === '' ? 'target/' : `${relRoot}/target/`
 }
 
 /**
@@ -62,7 +76,8 @@ export async function lint(ctx) {
   const srcTauriDirs = await findSrcTauriDirs(cwd)
   if (srcTauriDirs.length === 0) return reporter.result()
 
-  const expectedEntries = srcTauriDirs.map(dir => expectedTargetEntry(cwd, dir))
+  const expectedEntries = []
+  for (const dir of srcTauriDirs) expectedEntries.push(await expectedTargetEntry(cwd, dir))
   const abs = join(cwd, ROOT_GITIGNORE)
   const content = existsSync(abs) ? await readFile(abs, 'utf8') : ''
 

package/scripts/utils/cargo-workspace.mjs

@@ -0,0 +1,99 @@
+/**
+ * Спільні T0 (без spawn `cargo`) утиліти для роботи з Cargo workspace-структурою:
+ * читання Cargo.toml, резолв `[workspace].members`-glob-патернів у каталоги,
+ * пошук найближчого предка-workspace root для крейту. Спільно використовується
+ * `plugins/lang-rust/rules/rust/workspace_root` і `npm/rules/tauri/gitignore_target`.
+ */
+import { existsSync } from 'node:fs'
+import { readFile } from 'node:fs/promises'
+import { dirname, join, resolve } from 'node:path'
+
+import { parse as parseToml } from 'smol-toml'
+
+import { scanGlob } from './glob-compat.mjs'
+
+const TRAILING_SLASH_RE = /\/$/
+
+/**
+ * Розпарсений Cargo.toml або null (файл відсутній чи невалідний TOML).
+ * @param {string} absPath абсолютний шлях до Cargo.toml
+ * @returns {Promise<Record<string, unknown>|null>} розпарсений маніфест або null
+ */
+export async function readCargoManifest(absPath) {
+  if (!existsSync(absPath)) return null
+  try {
+    return parseToml(await readFile(absPath, 'utf8'))
+  } catch {
+    return null
+  }
+}
+
+/**
+ * Резолвить `[workspace].members`/`.exclude`-патерни (літеральні шляхи й прості
+ * glob з `*`) відносно `rootDir` у список абсолютних каталогів, що мають власний
+ * Cargo.toml. Без повної Cargo glob-семантики — лише `*`-сегменти й літерали.
+ * @param {string} rootDir корінь workspace (каталог з Cargo.toml, де живе `[workspace]`)
+ * @param {string[]} patterns патерни з `members`/`exclude`
+ * @returns {Promise<string[]>} абсолютні шляхи (без дублікатів)
+ */
+export async function resolveWorkspaceMemberDirs(rootDir, patterns) {
+  const found = new Set()
+  for (const pattern of patterns ?? []) {
+    const norm = pattern.replace(TRAILING_SLASH_RE, '')
+    if (norm.includes('*')) {
+      // Шаблон для `Cargo.toml` напряму (не для каталогів) — деякі раннери (Bun.Glob)
+      // за замовчуванням матчать лише файли, тож патерн на голий каталог даватиме 0 збігів.
+      for await (const relManifest of scanGlob(`${norm}/Cargo.toml`, rootDir)) {
+        found.add(resolve(rootDir, dirname(relManifest)))
+      }
+      continue
+    }
+    const abs = resolve(rootDir, norm)
+    if (existsSync(join(abs, 'Cargo.toml'))) found.add(abs)
+  }
+  return [...found]
+}
+
+/**
+ * Чи покриває `[workspace].members` (мінус `.exclude`) конкретний каталог-крейт.
+ * @param {string} rootDir корінь workspace
+ * @param {string} crateDirAbs абсолютний шлях крейту
+ * @param {string[]} members `workspace.members`
+ * @param {string[]} excludes `workspace.exclude`
+ * @returns {Promise<boolean>} true — крейт є членом workspace
+ */
+export async function isWorkspaceMemberDir(rootDir, crateDirAbs, members, excludes) {
+  const target = resolve(crateDirAbs)
+  const memberDirs = await resolveWorkspaceMemberDirs(rootDir, members)
+  if (memberDirs.every(d => resolve(d) !== target)) return false
+  if (!excludes || excludes.length === 0) return true
+  const excludedDirs = await resolveWorkspaceMemberDirs(rootDir, excludes)
+  return excludedDirs.every(d => resolve(d) !== target)
+}
+
+/**
+ * Йде від `dirname(crateDirAbs)` вгору по предках до `repoRootAbs` (включно),
+ * шукаючи найближчий Cargo.toml з `[workspace]`, чиї `members` (мінус `exclude`)
+ * покривають `crateDirAbs`. Не перевіряє сам `crateDirAbs` (виклик для нього — окремо).
+ * @param {string} crateDirAbs абсолютний шлях крейту (напр. `<repo>/owner/src-tauri`)
+ * @param {string} repoRootAbs абсолютний корінь репозиторію (межа обходу вгору)
+ * @returns {Promise<{rootDir: string, parsed: Record<string, unknown>}|null>} найближчий ancestor workspace root або null
+ */
+export async function findAncestorWorkspaceRoot(crateDirAbs, repoRootAbs) {
+  const stopAt = resolve(repoRootAbs)
+  let dir = dirname(resolve(crateDirAbs))
+  for (;;) {
+    const parsed = await readCargoManifest(join(dir, 'Cargo.toml'))
+    if (parsed?.workspace) {
+      const members = Array.isArray(parsed.workspace.members) ? parsed.workspace.members : []
+      const excludes = Array.isArray(parsed.workspace.exclude) ? parsed.workspace.exclude : []
+      if (await isWorkspaceMemberDir(dir, crateDirAbs, members, excludes)) {
+        return { rootDir: dir, parsed }
+      }
+    }
+    if (dir === stopAt) return null
+    const parent = dirname(dir)
+    if (parent === dir) return null
+    dir = parent
+  }
+}

package/scripts/utils/docs/cargo-workspace.md

@@ -0,0 +1,40 @@
+---
+type: JS Module
+title: cargo-workspace.mjs
+resource: npm/scripts/utils/cargo-workspace.mjs
+docgen:
+  crc: c852e1fe
+  model: openai-codex/gpt-5.4-mini
+  tier: cloud-min
+  score: 100
+  issues: judge:inaccurate:0.98
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+Спільні утиліти для читання `Cargo.toml`, розгортання `[workspace].members`-glob-патернів у каталоги та пошуку найближчого предка-workspace root для крейта. Публічні `readCargoManifest`, `resolveWorkspaceMemberDirs`, `isWorkspaceMemberDir`, `findAncestorWorkspaceRoot` працюють без запуску `cargo`, перехоплюють помилки й у частині випадків повертають порожнє значення замість винятку, щоб інші правила могли безпечно перевіряти належність каталогу до workspace або знаходити workspace root.
+
+## Поведінка
+
+- **readCargoManifest** — читає `Cargo.toml` і повертає розпарсений manifest, або `null`, якщо файл відсутній чи TOML невалідний.
+- **resolveWorkspaceMemberDirs** — перетворює workspace-патерни на список абсолютних каталогів із власним `Cargo.toml`, усуваючи дублікати.
+- **isWorkspaceMemberDir** — визначає, чи належить конкретний каталог до workspace з урахуванням `members` і `exclude`.
+- **findAncestorWorkspaceRoot** — шукає найближчий предок `Cargo.toml` з `[workspace]`, чий workspace покриває крейт; сам каталог крейту не перевіряє.
+
+## Публічний API
+
+- readCargoManifest — Розпарсений Cargo.toml або null (файл відсутній чи невалідний TOML).
+- resolveWorkspaceMemberDirs — Резолвить `[workspace].members`/`.exclude`-патерни (літеральні шляхи й прості
+glob з `*`) відносно `rootDir` у список абсолютних каталогів, що мають власний
+Cargo.toml. Без повної Cargo glob-семантики — лише `*`-сегменти й літерали.
+- isWorkspaceMemberDir — Чи покриває `[workspace].members` (мінус `.exclude`) конкретний каталог-крейт.
+- findAncestorWorkspaceRoot — Йде від `dirname(crateDirAbs)` вгору по предках до `repoRootAbs` (включно),
+шукаючи найближчий Cargo.toml з `[workspace]`, чиї `members` (мінус `exclude`)
+покривають `crateDirAbs`. Не перевіряє сам `crateDirAbs` (виклик для нього — окремо).
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).
+- Перехоплює помилки і не пропускає винятків назовні (fail-safe).
+- За певних помилок повертає порожнє значення (напр. `null`) замість винятку.

package/scripts/utils/docs/index.md

@@ -9,6 +9,7 @@ resource: npm/scripts/utils/
 | [apply-to-files.mjs](apply-to-files.md)                     | JS Module |
 | [ast-extract.mjs](ast-extract.md)                           | JS Module |
 | [ast-scan-utils.mjs](ast-scan-utils.md)                     | JS Module |
+| [cargo-workspace.mjs](cargo-workspace.md)                   | JS Module |
 | [ensure-gitignore-entries.mjs](ensure-gitignore-entries.md) | JS Module |
 | [find-package-json-paths.mjs](find-package-json-paths.md)   | JS Module |
 | [glob-compat.mjs](glob-compat.md)                           | JS Module |