@nitra/cursor 1.9.16 → 1.9.17

package/CHANGELOG.md

@@ -4,6 +4,24 @@
 
 Формат — [Keep a Changelog](https://keepachangelog.com/uk/1.1.0/), нумерація — [SemVer](https://semver.org/lang/uk/).
 
+## [1.9.17] - 2026-05-13
+
+### Added
+
+- **2 нові rego-полісі для text.mdc VSCode-канону** (мігровано з `check-text.mjs`):
+  - `text.vscode_extensions` — `recommendations` має містити три розширення: `DavidAnson.vscode-markdownlint`, `oxc.oxc-vscode`, `timonwong.shellcheck`. Шаблон повідомлень + множина `recommendations_set` (винесена поза `deny`, щоб не порушити `performance/non-loop-expression`).
+  - `text.vscode_settings` — `editor.formatOnSave: true` плюс шість мов-блоків (`[javascript]`/`[typescript]`/`[json]`/`[vue]`/`[css]`/`[html]`) з `editor.defaultFormatter: "oxc.oxc-vscode"`. Окремі deny для «не object» і «неправильний defaultFormatter». Канон задає мінімум — додаткові lang-блоки дозволені.
+- **18 нових rego-тестів** (7 для `vscode_extensions` + 11 для `vscode_settings`): happy path, додаткові поля, відсутність кожного розширення, відсутність `formatOnSave`, неправильний defaultFormatter, відсутні lang-блоки. `conftest verify` — **252/252 pass** (+18).
+- **`lint-conftest.mjs` TARGETS — два нові entry для text:** `text.vscode_extensions` (`single: '.vscode/extensions.json'`) і `text.vscode_settings` (`single: '.vscode/settings.json'`), обидва з `rule: 'text'`. Глобально активуються для всіх проєктів з `text` у `.n-cursor.json:rules`.
+
+### Removed
+
+- **`check-text.mjs::checkVscodeTextExtensions` / `checkVscodeTextSettings` / `checkVscodeText`** — три JS-функції видалено разом з викликом `await checkVscodeText(pass, fail)` у `check()`. Зміст delegated у rego (`text.vscode_extensions` + `text.vscode_settings`).
+
+### Changed
+
+- **`check-text.mjs::checkTextConfigsExistence` — розширено двома записами:** тепер вимагає FS-існування `.vscode/extensions.json` і `.vscode/settings.json` поряд з `.oxfmtrc.json` / `.cspell.json` / `.markdownlint-cli2.jsonc`. lint-conftest з rego skip-ить неіснуючі файли, тому FS-existence лишається в JS — це працює як «єдина точка контролю наявності файлу + delegated content-валідація у rego».
+
 ## [1.9.16] - 2026-05-13
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nitra/cursor",
-  "version": "1.9.16",
+  "version": "1.9.17",
   "description": "CLI для завантаження cursor-правил (префікс n-) у локальний репозиторій",
   "keywords": [
     "cli",

package/policy/text/vscode_extensions/vscode_extensions.rego

@@ -0,0 +1,36 @@
+# Перевірка `.vscode/extensions.json` для text (text.mdc).
+#
+# Запуск (локально):
+#   conftest test .vscode/extensions.json -p npm/policy/text/vscode_extensions \
+#     --namespace text.vscode_extensions
+#
+# Canonical (text.mdc): у `recommendations` мають бути три розширення
+#   - DavidAnson.vscode-markdownlint
+#   - oxc.oxc-vscode
+#   - timonwong.shellcheck
+#
+# Канон задає мінімум — додаткові записи (від інших правил) дозволені.
+#
+# Структура каталогу збігається зі шляхом пакету (regal: directory-package-mismatch).
+package text.vscode_extensions
+
+import rego.v1
+
+required_extensions := {
+	"DavidAnson.vscode-markdownlint",
+	"oxc.oxc-vscode",
+	"timonwong.shellcheck",
+}
+
+missing_extension_template := ".vscode/extensions.json: recommendations має містити %q (text.mdc)"
+
+# Множина усіх записів `recommendations` (вираз поза deny — щоб regal не лаявся
+# performance/non-loop-expression: інакше `object.get` виконувався б на кожній
+# ітерації по `required_extensions`).
+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/policy/text/vscode_extensions/vscode_extensions_test.rego

@@ -0,0 +1,51 @@
+# Тести для `text.vscode_extensions`. Запуск:
+#   conftest verify -p npm/policy/text/vscode_extensions
+package text.vscode_extensions_test
+
+import rego.v1
+
+import data.text.vscode_extensions
+
+canonical := {"recommendations": [
+	"DavidAnson.vscode-markdownlint",
+	"oxc.oxc-vscode",
+	"timonwong.shellcheck",
+]}
+
+test_allow_canonical if {
+	count(vscode_extensions.deny) == 0 with input as canonical
+}
+
+test_allow_with_additional_extensions if {
+	cfg := {"recommendations": [
+		"DavidAnson.vscode-markdownlint",
+		"oxc.oxc-vscode",
+		"timonwong.shellcheck",
+		"dbaeumer.vscode-eslint",
+		"stylelint.vscode-stylelint",
+	]}
+	count(vscode_extensions.deny) == 0 with input as cfg
+}
+
+test_deny_missing_markdownlint if {
+	cfg := {"recommendations": ["oxc.oxc-vscode", "timonwong.shellcheck"]}
+	count(vscode_extensions.deny) > 0 with input as cfg
+}
+
+test_deny_missing_oxc if {
+	cfg := {"recommendations": ["DavidAnson.vscode-markdownlint", "timonwong.shellcheck"]}
+	count(vscode_extensions.deny) > 0 with input as cfg
+}
+
+test_deny_missing_shellcheck if {
+	cfg := {"recommendations": ["DavidAnson.vscode-markdownlint", "oxc.oxc-vscode"]}
+	count(vscode_extensions.deny) > 0 with input as cfg
+}
+
+test_deny_empty_recommendations if {
+	count(vscode_extensions.deny) > 0 with input as {"recommendations": []}
+}
+
+test_deny_no_recommendations_field if {
+	count(vscode_extensions.deny) > 0 with input as {}
+}

package/policy/text/vscode_settings/vscode_settings.rego

@@ -0,0 +1,56 @@
+# Перевірка `.vscode/settings.json` для text (text.mdc).
+#
+# Запуск (локально):
+#   conftest test .vscode/settings.json -p npm/policy/text/vscode_settings \
+#     --namespace text.vscode_settings
+#
+# Canonical (text.mdc):
+#   { "editor.formatOnSave": true,
+#     "[javascript]": { "editor.defaultFormatter": "oxc.oxc-vscode" },
+#     "[typescript]": { "editor.defaultFormatter": "oxc.oxc-vscode" },
+#     "[json]":       { "editor.defaultFormatter": "oxc.oxc-vscode" },
+#     "[vue]":        { "editor.defaultFormatter": "oxc.oxc-vscode" },
+#     "[css]":        { "editor.defaultFormatter": "oxc.oxc-vscode" },
+#     "[html]":       { "editor.defaultFormatter": "oxc.oxc-vscode" } }
+#
+# Структура каталогу збігається зі шляхом пакету (regal: directory-package-mismatch).
+package text.vscode_settings
+
+import rego.v1
+
+language_keys := {"[javascript]", "[typescript]", "[json]", "[vue]", "[css]", "[html]"}
+
+# Шаблони повідомлень — через `concat` для regal style/line-length.
+lang_block_not_object_template := concat(" ", [
+	".vscode/settings.json: %q має бути обʼєктом з",
+	"\"editor.defaultFormatter\": \"oxc.oxc-vscode\" (text.mdc)",
+])
+
+lang_wrong_formatter_template := concat(" ", [
+	".vscode/settings.json: %q має використовувати",
+	"\"oxc.oxc-vscode\" як editor.defaultFormatter (text.mdc)",
+])
+
+# ── deny: editor.formatOnSave ────────────────────────────────────────────
+
+deny contains msg if {
+	object.get(input, "editor.formatOnSave", null) != true
+	msg := ".vscode/settings.json: \"editor.formatOnSave\" має бути true (text.mdc)"
+}
+
+# ── deny: [lang].editor.defaultFormatter ────────────────────────────────
+
+deny contains msg if {
+	some key in language_keys
+	block := object.get(input, key, {})
+	not is_object(block)
+	msg := sprintf(lang_block_not_object_template, [key])
+}
+
+deny contains msg if {
+	some key in language_keys
+	block := object.get(input, key, {})
+	is_object(block)
+	object.get(block, "editor.defaultFormatter", null) != "oxc.oxc-vscode"
+	msg := sprintf(lang_wrong_formatter_template, [key])
+}

package/policy/text/vscode_settings/vscode_settings_test.rego

@@ -0,0 +1,85 @@
+# Тести для `text.vscode_settings`. Запуск:
+#   conftest verify -p npm/policy/text/vscode_settings
+package text.vscode_settings_test
+
+import rego.v1
+
+import data.text.vscode_settings
+
+valid_cfg := {
+	"editor.formatOnSave": true,
+	"[javascript]": {"editor.defaultFormatter": "oxc.oxc-vscode"},
+	"[typescript]": {"editor.defaultFormatter": "oxc.oxc-vscode"},
+	"[json]": {"editor.defaultFormatter": "oxc.oxc-vscode"},
+	"[vue]": {"editor.defaultFormatter": "oxc.oxc-vscode"},
+	"[css]": {"editor.defaultFormatter": "oxc.oxc-vscode"},
+	"[html]": {"editor.defaultFormatter": "oxc.oxc-vscode"},
+}
+
+# ── happy path ────────────────────────────────────────────────────────────
+
+test_allow_canonical if {
+	count(vscode_settings.deny) == 0 with input as valid_cfg
+}
+
+test_allow_with_additional_lang_block if {
+	cfg := json.patch(valid_cfg, [{
+		"op": "add",
+		"path": "/[python]",
+		"value": {"editor.defaultFormatter": "ms-python.python"},
+	}])
+	count(vscode_settings.deny) == 0 with input as cfg
+}
+
+# ── deny: editor.formatOnSave ────────────────────────────────────────────
+
+test_deny_format_on_save_false if {
+	cfg := json.patch(valid_cfg, [{"op": "replace", "path": "/editor.formatOnSave", "value": false}])
+	count(vscode_settings.deny) > 0 with input as cfg
+}
+
+test_deny_format_on_save_missing if {
+	cfg := json.patch(valid_cfg, [{"op": "remove", "path": "/editor.formatOnSave"}])
+	count(vscode_settings.deny) > 0 with input as cfg
+}
+
+# ── deny: lang formatters (per-key) ──────────────────────────────────────
+
+test_deny_javascript_missing if {
+	cfg := json.patch(valid_cfg, [{"op": "remove", "path": "/[javascript]"}])
+	count(vscode_settings.deny) > 0 with input as cfg
+}
+
+test_deny_typescript_wrong_formatter if {
+	cfg := json.patch(
+		valid_cfg,
+		[{"op": "replace", "path": "/[typescript]/editor.defaultFormatter", "value": "prettier"}],
+	)
+	count(vscode_settings.deny) > 0 with input as cfg
+}
+
+test_deny_json_block_not_object if {
+	cfg := json.patch(valid_cfg, [{"op": "replace", "path": "/[json]", "value": "oxc.oxc-vscode"}])
+	count(vscode_settings.deny) > 0 with input as cfg
+}
+
+test_deny_vue_missing_default_formatter if {
+	cfg := json.patch(valid_cfg, [{"op": "replace", "path": "/[vue]", "value": {"editor.tabSize": 2}}])
+	count(vscode_settings.deny) > 0 with input as cfg
+}
+
+test_deny_css_missing if {
+	cfg := json.patch(valid_cfg, [{"op": "remove", "path": "/[css]"}])
+	count(vscode_settings.deny) > 0 with input as cfg
+}
+
+test_deny_html_missing if {
+	cfg := json.patch(valid_cfg, [{"op": "remove", "path": "/[html]"}])
+	count(vscode_settings.deny) > 0 with input as cfg
+}
+
+# ── deny: empty object ───────────────────────────────────────────────────
+
+test_deny_empty_object if {
+	count(vscode_settings.deny) > 0 with input as {}
+}

package/scripts/check-text.mjs

@@ -89,70 +89,11 @@ async function checkV8rIgnore(passFn, failFn) {
   }
 }
 
-/**
- * Перевіряє VSCode extensions.json для текстового стека.
- * @param {(msg: string) => void} passFn callback при успішній перевірці
- * @param {(msg: string) => void} failFn callback при помилці
- */
-async function checkVscodeTextExtensions(passFn, failFn) {
-  if (!existsSync('.vscode/extensions.json')) {
-    failFn('.vscode/extensions.json не існує — створи з recommendations згідно n-text.mdc')
-    return
-  }
-  try {
-    const ext = JSON.parse(await readFile('.vscode/extensions.json', 'utf8'))
-    const rec = ext.recommendations
-    for (const id of ['DavidAnson.vscode-markdownlint', 'oxc.oxc-vscode', 'timonwong.shellcheck']) {
-      if (Array.isArray(rec) && rec.includes(id)) {
-        passFn(`extensions.json містить ${id}`)
-      } else {
-        failFn(`extensions.json: додай "${id}" у recommendations (див. n-text.mdc)`)
-      }
-    }
-  } catch {
-    failFn('.vscode/extensions.json — невалідний JSON')
-  }
-}
-
-/**
- * Перевіряє VSCode settings.json для текстового стека.
- * @param {(msg: string) => void} passFn callback при успішній перевірці
- * @param {(msg: string) => void} failFn callback при помилці
- */
-async function checkVscodeTextSettings(passFn, failFn) {
-  if (!existsSync('.vscode/settings.json')) {
-    failFn('.vscode/settings.json не існує — створи згідно n-text.mdc')
-    return
-  }
-  try {
-    const settings = JSON.parse(await readFile('.vscode/settings.json', 'utf8'))
-    if (settings['editor.formatOnSave'] === true) {
-      passFn('settings.json: editor.formatOnSave увімкнено')
-    } else {
-      failFn('settings.json: editor.formatOnSave має бути true')
-    }
-    for (const t of ['javascript', 'typescript', 'json', 'vue', 'css', 'html']) {
-      const key = `[${t}]`
-      if (settings[key]?.['editor.defaultFormatter'] === 'oxc.oxc-vscode') {
-        passFn(`settings.json: ${key} використовує oxc.oxc-vscode`)
-      } else {
-        failFn(`settings.json: ${key} має використовувати oxc.oxc-vscode як defaultFormatter`)
-      }
-    }
-  } catch {
-    failFn('.vscode/settings.json — невалідний JSON')
-  }
-}
-
-/**
- * Перевіряє VSCode extensions.json та settings.json для текстового стека.
- * @param {(msg: string) => void} passFn callback при успішній перевірці
- * @param {(msg: string) => void} failFn callback при помилці
- */
-async function checkVscodeText(passFn, failFn) {
-  await checkVscodeTextExtensions(passFn, failFn)
-  await checkVscodeTextSettings(passFn, failFn)
-}
+// `.vscode/extensions.json` (`DavidAnson.vscode-markdownlint`, `oxc.oxc-vscode`,
+// `timonwong.shellcheck`) і `.vscode/settings.json` (`editor.formatOnSave` +
+// `[lang].editor.defaultFormatter`) валідують rego-пакети `text.vscode_extensions`
+// і `text.vscode_settings` (зареєстровані глобально у `lint-conftest.mjs` TARGETS
+// з `rule: 'text'`). FS-existence файлів — у `checkTextConfigsExistence`.
 
 /**
  * FS-existence стек текстових конфігів. Контент-валідація — у Rego
@@ -165,7 +106,9 @@ function checkTextConfigsExistence(passFn, failFn) {
   for (const [path, mdcRef] of [
     ['.oxfmtrc.json', 'text.oxfmtrc'],
     ['.cspell.json', 'text.cspell'],
-    ['.markdownlint-cli2.jsonc', 'text.markdownlint']
+    ['.markdownlint-cli2.jsonc', 'text.markdownlint'],
+    ['.vscode/extensions.json', 'text.vscode_extensions'],
+    ['.vscode/settings.json', 'text.vscode_settings']
   ]) {
     if (existsSync(path)) {
       passFn(`${path} є (структуру перевіряє bun run lint-conftest → ${mdcRef})`)
@@ -247,7 +190,6 @@ export async function check() {
   const { pass, fail } = reporter
 
   await checkV8rIgnore(pass, fail)
-  await checkVscodeText(pass, fail)
   await checkTextConfigsExistence(pass, fail)
 
   for (const f of ['.prettierrc', '.prettierrc.json', '.prettierrc.js', 'prettier.config.js', '.prettierrc.yml']) {

package/scripts/lint-conftest.mjs

@@ -103,6 +103,8 @@ const TARGETS = [
   { namespace: 'text.cspell', policyDir: 'text', rule: 'text', single: '.cspell.json' },
   { namespace: 'text.markdownlint', policyDir: 'text', rule: 'text', single: '.markdownlint-cli2.jsonc' },
   { namespace: 'text.package_json', policyDir: 'text', rule: 'text', single: 'package.json' },
+  { namespace: 'text.vscode_extensions', policyDir: 'text', rule: 'text', single: '.vscode/extensions.json' },
+  { namespace: 'text.vscode_settings', policyDir: 'text', rule: 'text', single: '.vscode/settings.json' },
 
   // ── style-lint ──────────────────────────────────────────────────────────
   { namespace: 'style_lint.package_json', policyDir: 'style_lint', rule: 'style-lint', single: 'package.json' },