@7n/rules 1.38.0 → 1.39.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [1.39.0] - 2026-07-21
+
+### Added
+
+- workspace_root: канон одного кореневого uv workspace на репозиторій (дзеркало rust/workspace_root), main.json auto-glob розширено на вкладені pyproject.toml
+
 ## [1.38.0] - 2026-07-21
 
 ### Fixed

package/package.json

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

package/scripts/utils/docs/index.md

@@ -20,6 +20,7 @@ resource: npm/scripts/utils/
 | [resolve-js-root.mjs](resolve-js-root.md)                   | JS Module |
 | [spawn-async.mjs](spawn-async.md)                           | JS Module |
 | [test-helpers.mjs](test-helpers.md)                         | JS Module |
+| [uv-workspace.mjs](uv-workspace.md)                         | JS Module |
 | [walk-cache.mjs](walk-cache.md)                             | JS Module |
 | [walkDir.mjs](walkDir.md)                                   | JS Module |
 | [with-lock.mjs](with-lock.md)                               | JS Module |

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

@@ -0,0 +1,34 @@
+---
+type: JS Module
+title: uv-workspace.mjs
+resource: npm/scripts/utils/uv-workspace.mjs
+docgen:
+  crc: b7602da3
+  model: openai-codex/gpt-5.4-mini
+  tier: cloud-min
+  score: 100
+  issues: judge:inaccurate:0.98
+  judgeModel: openai-codex/gpt-5.4-mini
+---
+
+## Огляд
+
+`readPyprojectManifest` читає `pyproject.toml` і повертає маніфест uv workspace, а `resolveUvWorkspaceMemberDirs` резолвить каталоги з `[tool.uv.workspace].members` та `.exclude` за тією самою glob-семантикою, що й у Cargo workspaces. Це read-only, fail-safe набір спільних T0-утиліт: він не пише у ФС чи БД, не кидає винятків назовні та для частини помилок повертає порожнє значення замість помилки.
+
+## Поведінка
+
+- `readPyprojectManifest` — читає `pyproject.toml` для uv workspace і повертає розпарсений manifest або `null`, якщо файл відсутній чи TOML невалідний.
+- `resolveUvWorkspaceMemberDirs` — перетворює `members` і `exclude` uv workspace на список абсолютних каталогів із власним `pyproject.toml`, враховуючи літеральні шляхи та прості glob-патерни.
+
+## Публічний API
+
+- readPyprojectManifest — Розпарсений pyproject.toml або null (файл відсутній чи невалідний TOML).
+- resolveUvWorkspaceMemberDirs — Резолвить `[tool.uv.workspace].members`/`.exclude`-патерни (літеральні шляхи й прості
+glob з `*`) відносно `rootDir` у список абсолютних каталогів, що мають власний
+pyproject.toml. Без повної glob-семантики uv — лише `*`-сегменти й літерали.
+
+## Гарантії поведінки
+
+- Read-only: не виконує операцій запису (ФС/БД).
+- Перехоплює помилки і не пропускає винятків назовні (fail-safe).
+- За певних помилок повертає порожнє значення (напр. `null`) замість винятку.

package/scripts/utils/uv-workspace.mjs

@@ -0,0 +1,56 @@
+/**
+ * Спільні T0 (без spawn `uv`) утиліти для роботи з uv workspace-структурою: читання
+ * `pyproject.toml`, резолв `[tool.uv.workspace].members`/`.exclude`-glob-патернів у
+ * каталоги. Дзеркалить `cargo-workspace.mjs` (rust/workspace_root) — uv workspaces
+ * навмисно змодельовані на Cargo workspaces, glob-семантика `members`/`exclude` та сама.
+ * Не імпортується напряму з rust-боку (окремі плагіни) — дублювання свідоме.
+ */
+import { existsSync } from 'node:fs'
+import { readFile } from 'node:fs/promises'
+import { dirname, resolve } from 'node:path'
+
+import { parse as parseToml } from 'smol-toml'
+
+import { scanGlob } from './glob-compat.mjs'
+
+const TRAILING_SLASH_RE = /\/$/
+
+/**
+ * Розпарсений pyproject.toml або null (файл відсутній чи невалідний TOML).
+ * @param {string} absPath абсолютний шлях до pyproject.toml
+ * @returns {Promise<Record<string, unknown>|null>} розпарсений маніфест або null
+ */
+export async function readPyprojectManifest(absPath) {
+  if (!existsSync(absPath)) return null
+  try {
+    return parseToml(await readFile(absPath, 'utf8'))
+  } catch {
+    return null
+  }
+}
+
+/**
+ * Резолвить `[tool.uv.workspace].members`/`.exclude`-патерни (літеральні шляхи й прості
+ * glob з `*`) відносно `rootDir` у список абсолютних каталогів, що мають власний
+ * pyproject.toml. Без повної glob-семантики uv — лише `*`-сегменти й літерали.
+ * @param {string} rootDir корінь workspace (каталог з pyproject.toml, де живе `[tool.uv.workspace]`)
+ * @param {string[]} patterns патерни з `members`/`exclude`
+ * @returns {Promise<string[]>} абсолютні шляхи (без дублікатів)
+ */
+export async function resolveUvWorkspaceMemberDirs(rootDir, patterns) {
+  const found = new Set()
+  for (const pattern of patterns ?? []) {
+    const norm = pattern.replace(TRAILING_SLASH_RE, '')
+    if (norm.includes('*')) {
+      // Патерн для pyproject.toml напряму (не для каталогів) — деякі раннери (Bun.Glob)
+      // за замовчуванням матчать лише файли, тож патерн на голий каталог даватиме 0 збігів.
+      for await (const relManifest of scanGlob(`${norm}/pyproject.toml`, rootDir)) {
+        found.add(resolve(rootDir, dirname(relManifest)))
+      }
+      continue
+    }
+    const abs = resolve(rootDir, norm)
+    if (existsSync(`${abs}/pyproject.toml`)) found.add(abs)
+  }
+  return [...found]
+}