@nitra/cursor 3.20.0 → 3.21.0

package/.claude-template/hooks/capture-decisions.sh

@@ -199,7 +199,7 @@ if ! printf '%s' "$RESPONSE_TRIMMED" | grep -q '^## '; then
   exit 0
 fi
 
-TS=$(date +%Y%m%d-%H%M%S)
+TS=$(date +%y%m%d-%H%M)
 
 # Slug із першого `## [ADR|Runbook|Knowledge] <heading>`-рядка відповіді.
 # Логіка локальна (без додаткового LLM-виклику): використовуємо вже згенерований heading.

package/.claude-template/hooks/normalize-decisions.sh

@@ -407,11 +407,15 @@ while IFS= read -r op_json; do
           continue
           ;;
       esac
-      # Keep the draft's `YYYYMMDD-HHMMSS-` prefix on the clean file: the name
+      # Keep the draft's timestamp prefix on the clean file: the name
       # stays anchored to capture time, only the slug part changes between draft
-      # and clean, and docs/adr/ keeps sorting chronologically. Drafts without a
-      # timestamp prefix fall back to a bare `<slug>.md`.
+      # and clean, and docs/adr/ keeps sorting chronologically. New drafts use
+      # `YYMMDD-HHMM-`; older `YYYYMMDD-HHMMSS-` drafts are still supported.
+      # Drafts without a timestamp prefix fall back to a bare `<slug>.md`.
       case "$FILE" in
+        [0-9][0-9][0-9][0-9][0-9][0-9]-[0-9][0-9][0-9][0-9]-*)
+          DEST_SLUG="$(printf '%s' "$FILE" | cut -c1-11)-$SLUG"
+          ;;
         [0-9][0-9][0-9][0-9][0-9][0-9][0-9][0-9]-[0-9][0-9][0-9][0-9][0-9][0-9]-*)
           DEST_SLUG="$(printf '%s' "$FILE" | cut -c1-15)-$SLUG"
           ;;
@@ -444,7 +448,7 @@ while IFS= read -r op_json; do
           ;;
       esac
       # Resolve the target clean file. The LLM gives a bare `<slug>.md`, but the
-      # real file usually carries a `YYYYMMDD-HHMMSS-` prefix. Try, in order:
+      # real file usually carries a timestamp prefix. Try, in order:
       #   1. exact name in docs/adr/,
       #   2. a rewrite of this batch that produced that slug (SLUG_MAP),
       #   3. a unique existing clean file whose name ends with `-<slug>.md`.

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## [3.21.0] - 2026-06-04
+
+### Added
+
+- Root-guard для всіх деструктивних точок: CLI-команди fix/lint/coverage/change/release + дефолтний sync хардом перевіряють cwd===git-toplevel (assertCwdIsProjectRoot); worktree-preflight підсилено root-assert (pwd vs toplevel); новий meta.json-флаг requireRoot + injectRootNotice для in-place root-only скілів (n-start-check); skillRequiresRoot як явна похідна ознака захисту; валідація requireRoot у npm-module
+- sync .gitignore: ігнорувати .claude/scheduled_tasks.lock (runtime-lock планувальника)
+
+### Changed
+
+- Скорочено timestamp-префікси ADR і change-файлів до YYMMDD-HHMM; додано атомарний suffix для локальних колізій та заборону Temporal у Bun runtime.
+
+### Fixed
+
+- n-changelog: directional version-drift — лише version ВПЕРЕД (> опублікованої/git-бази) валить як ручний bump; version ПОЗАДУ (локаль відстала від CI-релізу, ще не git pull) більше не блокує коміт (compareSemverCore/versionIsAhead)
+
 ## [3.20.0] - 2026-06-03
 
 ### Added

package/bin/n-cursor.js

@@ -92,6 +92,7 @@ import {
 import { detectAutoSkills } from '../scripts/auto-skills.mjs'
 import { readSkillMetaRaw } from '../scripts/lib/skill-meta.mjs'
 import { injectWorktreeNotice } from '../scripts/lib/worktree-notice.mjs'
+import { injectRootNotice } from '../scripts/lib/root-notice.mjs'
 import { runPostToolUseFixCli } from '../scripts/post-tool-use-fix.mjs'
 import { discoverCheckRulesFromCursorRules } from '../scripts/lib/discover-check-rules-from-cursor.mjs'
 import { listRuleIds } from '../scripts/lib/list-rule-ids.mjs'
@@ -787,6 +788,9 @@ async function syncSkills(configSkills, bundledSkillsDir = BUNDLED_SKILLS_DIR) {
         await mkdir(destDir, { recursive: true })
         const meta = readSkillMetaRaw(srcDir)
         const worktree = meta?.worktree === true
+        // root-guard для in-place скілів (мутують CWD без worktree-ізоляції).
+        // Worktree-скіли root-assert уже мають у worktree-блоці, тож тут лише !worktree.
+        const rootOnly = !worktree && meta?.requireRoot === true
         const entries = await readdir(srcDir, { withFileTypes: true })
         for (const entry of entries) {
           // Лише top-level файли скіла. `meta.json` — метадані (не для споживача);
@@ -796,6 +800,7 @@ async function syncSkills(configSkills, bundledSkillsDir = BUNDLED_SKILLS_DIR) {
           let content = await readFile(join(srcDir, entry.name), 'utf8')
           if (entry.name === 'SKILL.md') {
             content = injectWorktreeNotice(content, worktree)
+            content = injectRootNotice(content, rootOnly)
           }
           await writeFile(join(destDir, entry.name), content, 'utf8')
         }
@@ -1459,15 +1464,51 @@ async function runSync() {
   }
 }
 
+/**
+ * Команди, що мутують проєкт у CWD і вимагають кореня репо. `undefined`/`''` —
+ * дефолтний sync; `check` — deprecated-alias `fix`. Решта (read-only `trace`/
+ * `graph`, `--root`-команди `docgen`/`rename-yaml-extensions`, `worktree`,
+ * sub-лінтери) гард не зачіпає.
+ */
+const ROOT_GUARDED_COMMANDS = new Set([undefined, '', 'fix', 'check', 'lint', 'coverage', 'change', 'release'])
+
+/**
+ * Короткий опис дії для тексту root-guard помилки за іменем команди.
+ * @param {string | undefined} cmd підкоманда CLI (або undefined для дефолтного sync)
+ * @returns {string} фраза «що саме мутує CWD»
+ */
+function describeRootGuardedAction(cmd) {
+  switch (cmd) {
+    case undefined:
+    case '':
+      return 'Дефолтна синхронізація скаффолдить .cursor/, .claude/, CLAUDE.md, .n-cursor.json і робить bun install у поточному каталозі'
+    case 'fix':
+    case 'check':
+      return '`fix` запускає programmatic-перевірки правил, що переписують конфіги в поточному каталозі'
+    case 'lint':
+      return '`lint` запускає авто-fix лінтерів (oxfmt/eslint --fix/stylelint --fix) у поточному каталозі'
+    case 'coverage':
+      return '`coverage` генерує COVERAGE.md і Stryker-артефакти в поточному каталозі'
+    case 'change':
+      return '`change` пише change-файл у .changes/ поточного каталогу'
+    case 'release':
+      return '`release` бампає version і переписує CHANGELOG у поточному каталозі'
+    default:
+      return 'Команда @nitra/cursor мутує проєкт у поточному каталозі'
+  }
+}
+
 // CLI: маршрутизація команд
 const [command, ...args] = process.argv.slice(2)
 
 try {
-  // Дефолтний sync (без підкоманди) скаффолдить .cursor/.claude/CLAUDE.md/.n-cursor.json
-  // і робить bun install у cwd(). Guard до перших мутацій: заборона запуску з піддиректорії
-  // git-репо (типово прямий `bun npm/bin/n-cursor.js` не з кореня). Підкоманди не зачіпає.
-  if (command === undefined || command === '') {
-    assertCwdIsProjectRoot()
+  // Root-guard до перших мутацій: дефолтний sync скаффолдить .cursor/.claude/CLAUDE.md/
+  // .n-cursor.json + bun install, а fix/lint/coverage/change/release переписують файли в CWD —
+  // усе це ключиться на cwd(). Запуск із піддиректорії git-репо (типово прямий
+  // `bun npm/bin/n-cursor.js` не з кореня) зачепив би не той каталог → STOP. Read-only та
+  // `--root`-команди (trace, graph, docgen, rename-yaml-extensions) не зачіпаємо.
+  if (ROOT_GUARDED_COMMANDS.has(command)) {
+    assertCwdIsProjectRoot(cwd(), describeRootGuardedAction(command))
   }
   await ensureNitraCursorInRootDevDependencies(cwd())
   switch (command) {

package/package.json

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

package/rules/adr/adr.mdc

@@ -18,8 +18,8 @@ ADR живуть у єдиному каталозі **`docs/adr/`**. Clean ADR-
 
 Є два стани файлу, які відрізняються YAML frontmatter:
 
-- **Draft** — файл з frontmatter `session: …`, `captured: …`, `transcript: …` та timestamp-іменем `YYYYMMDD-HHMMSS-<sid>.md`. Пише `capture-decisions.sh` після кожної сесії.
-- **Clean** — файл без frontmatter, з kebab-case-іменем. `normalize-decisions.sh` зберігає timestamp-префікс чернетки → `YYYYMMDD-HHMMSS-<slug>.md` (наприклад `20260518-092807-ланцюжок-запуску-abie.md`); створений руками clean-файл може мати просто `<slug>.md`.
+- **Draft** — файл з frontmatter `session: …`, `captured: …`, `transcript: …` та timestamp-іменем `YYMMDD-HHMM-<sid>.md`. Пише `capture-decisions.sh` після кожної сесії.
+- **Clean** — файл без frontmatter, з kebab-case-іменем. `normalize-decisions.sh` зберігає timestamp-префікс чернетки → `YYMMDD-HHMM-<slug>.md` (наприклад `260518-0928-ланцюжок-запуску-abie.md`); створений руками clean-файл може мати просто `<slug>.md`.
 
 `normalize-decisions.sh` ніколи не чіпає clean-файли — крім випадку `merge-into`, коли дописує `## Update YYYY-MM-DD` в кінець наявного clean-файлу.
 
@@ -50,7 +50,7 @@ LLM повертає масив операцій:
 | `rewrite` | Чернетка стає окремим clean-файлом MADR v4 minimal: frontmatter знімається, ім'я → `<timestamp>-<slug>.md` (timestamp-префікс чернетки збережено), додаються `**Status:** Accepted`, `**Date:**` з `captured` і canonical MADR headings. | `file`, `slug`, `content` |
 | `merge-into` | Чернетка повторює тему вже існуючого clean-файлу; дописуємо `## Update YYYY-MM-DD` у кінець `target`. | `file`, `target`, `additions` |
 
-`slug` — kebab-case українською (`ланцюжок-запуску-abie`, `npm-publish-flow`); англійські технічні терміни лишаються англійською без транслітерації. До імені clean-файлу скрипт додає `YYYYMMDD-HHMMSS-` чернетки, тож запис лишається прив'язаним до часу capture, а `docs/adr/` сортується хронологічно. Колізія імен обробляється детермінованим суфіксом `-2`, `-3`.
+`slug` — kebab-case українською (`ланцюжок-запуску-abie`, `npm-publish-flow`); англійські технічні терміни лишаються англійською без транслітерації. До імені clean-файлу скрипт додає `YYMMDD-HHMM-` чернетки, тож запис лишається прив'язаним до часу capture, а `docs/adr/` сортується хронологічно. Колізія імен обробляється детермінованим суфіксом `-2`, `-3`. Старі чернетки з `YYYYMMDD-HHMMSS-` prefix нормалізатор також розпізнає, щоб не ламати наявний inbox.
 
 ### Жодних git-операцій
 
@@ -86,8 +86,8 @@ LLM повертає масив операцій:
 
 ```text
 docs/adr/
-├── YYYYMMDD-HHMMSS-<sid>.md     # drafts (frontmatter session:/captured:/transcript:)
-└── YYYYMMDD-HHMMSS-<slug>.md    # clean ADR-и (без frontmatter, timestamp-префікс чернетки збережено)
+├── YYMMDD-HHMM-<sid>.md       # drafts (frontmatter session:/captured:/transcript:)
+└── YYMMDD-HHMM-<slug>.md      # clean ADR-и (без frontmatter, timestamp-префікс чернетки збережено)
 .claude/hooks/
 ├── capture-decisions.sh       # auto-synced з пакета
 ├── normalize-decisions.sh     # auto-synced з пакета

package/rules/adr/js/templates/hooks/.gitignore.snippet

@@ -6,3 +6,4 @@ dist/
 .claude/hooks/*.log
 .claude/hooks/.normalize-state
 .claude/hooks/.normalize.lock
+.claude/scheduled_tasks.lock

package/rules/changelog/changelog.mdc

@@ -8,7 +8,7 @@ alwaysApply: true
 
 > **Якщо в цій сесії ти змінив(ла) файли в пакетному workspace** (код, rego, правила, скіли, скрипти, конфіги, тести — **не** лише `docs/` / `doc/`) — **не завершуй задачу**, поки не виконаєш **усі три** кроки нижче в **тому ж** наборі змін. Це не «опційно після синку» — це частина PR.
 
-1. **Поклади change-файл** `<ws>/.changes/<timestamp>-<rand>.md` з frontmatter `bump:` (`major|minor|patch`) + `section:` (`Added|Changed|Fixed|Removed`) і текстом опису. Команда: `npx @nitra/cursor change --bump <…> --section <…> --message "<…>" [--ws <шлях>]`.
+1. **Поклади change-файл** `<ws>/.changes/YYMMDD-HHMM.md` з frontmatter `bump:` (`major|minor|patch`) + `section:` (`Added|Changed|Fixed|Removed`) і текстом опису. Команда: `npx @nitra/cursor change --bump <…> --section <…> --message "<…>" [--ws <шлях>]`. Якщо файл за ту саму хвилину вже існує, CLI атомарно створює `YYMMDD-HHMM-2.md`, потім `-3` тощо.
 2. **Ніколи** не редагуй `version` і `CHANGELOG.md` вручну — навіть для hotfix. Єдиний артефакт зміни — change-файл; `version`/CHANGELOG формує `n-cursor release` у CI на `main` (агрегує change-файли, ставить git-тег `<name>@<version>`). Будь-яка зміна `version` поза CI (drift від бази чи опублікованої) завалює `check changelog` — навіть якщо поряд є change-файл.
 3. **`npx @nitra/cursor fix changelog`** → exit **`0`** (достатньо наявності change-файлу; `version` лишається незмінним).
 

package/rules/changelog/js/consistency.mjs

@@ -3,10 +3,12 @@
  * change-файл `<ws>/.changes/*.md` — єдиний дозволений артефакт зміни. Bump `version`
  * і генерацію `CHANGELOG.md` робить виключно `n-cursor release` у CI на `main`.
  *
- * Інваріант (на будь-якій гілці): `version` не має відхилятися від бази. Будь-який drift
- * `version` (vs опублікована в реєстрі або vs git-база) — ручний bump поза CI — завалює
- * перевірку, навіть якщо присутній change-файл. Pass лише коли є change-файл, а version
- * не зрушено; зміни без change-файлу — fail.
+ * Інваріант (на будь-якій гілці): `version` у дереві не має **випереджати** базу. Лише
+ * drift **уперед** (`version` > опублікованої в реєстрі / > git-бази) — ручний bump поза
+ * CI — завалює перевірку, навіть із change-файлом. Version **позаду** бази (локаль відстала
+ * від уже опублікованого CI-релізу, ще не зроблено `git pull`) — НЕ порушення: це не ручний
+ * bump, а git і так не дасть запушити non-fast-forward. Pass лише коли є change-файл, а
+ * version не випереджає базу; зміни без change-файлу — fail.
  *
  * Дві моделі бази — на рівні воркспейсу (див. n-changelog.mdc):
  *
@@ -318,6 +320,48 @@ function resolvePublishedVersion(manifest, getPublishedVersion) {
   return getPublishedVersion(manifest.name, manifest.kind)
 }
 
+/** Числове ядро semver (`x.y.z`); хвіст (prerelease/build) ігнорується. */
+const SEMVER_CORE_RE = /^(\d+)\.(\d+)\.(\d+)/
+
+/**
+ * Парсить числове ядро semver-рядка.
+ * @param {unknown} v версія
+ * @returns {{ major: number, minor: number, patch: number } | null} ядро або null
+ */
+function parseSemverCore(v) {
+  const m = typeof v === 'string' ? v.match(SEMVER_CORE_RE) : null
+  if (!m) return null
+  return { major: Number(m[1]), minor: Number(m[2]), patch: Number(m[3]) }
+}
+
+/**
+ * Порівнює semver-ядра двох версій.
+ * @param {unknown} a перша версія
+ * @param {unknown} b друга версія
+ * @returns {-1 | 0 | 1 | null} a<b → -1, a==b → 0, a>b → 1; null — нерозпізнано
+ */
+function compareSemverCore(a, b) {
+  const pa = parseSemverCore(a)
+  const pb = parseSemverCore(b)
+  if (!pa || !pb) return null
+  if (pa.major !== pb.major) return pa.major > pb.major ? 1 : -1
+  if (pa.minor !== pb.minor) return pa.minor > pb.minor ? 1 : -1
+  if (pa.patch !== pb.patch) return pa.patch > pb.patch ? 1 : -1
+  return 0
+}
+
+/**
+ * Чи `current` випереджає `base` (ручний bump поза CI). Якщо semver нерозпізнаний
+ * (null) — fail-closed на будь-яку нерівність (консервативно, як до directional-фікса).
+ * @param {unknown} current версія в дереві
+ * @param {unknown} base база (опублікована / git-база)
+ * @returns {boolean} true — current попереду base (або нерозпізнано й не рівні)
+ */
+function versionIsAhead(current, base) {
+  const cmp = compareSemverCore(current, base)
+  return cmp === null ? current !== base : cmp > 0
+}
+
 /**
  * @param {string} name пакет
  * @param {import('../lib/package-manifest.mjs').PackageKind} [kind] тип пакета
@@ -454,16 +498,28 @@ async function checkPublishedWorkspace(manifest, subWorkspaces, getPublishedVers
     pass(`${label}: ${name} — опублікована версія недоступна (мережа/реєстр), перевірку пропущено`)
     return
   }
-  // Drift від опублікованої версії має пріоритет над change-файлом: ручний bump
-  // заборонено навіть із change-файлом (симетрично з local-only-шляхом).
-  if (Vpublished !== Vcurrent) {
+  // Лише drift УПЕРЕД (version > опублікованої) — ручний bump поза CI; має пріоритет
+  // над change-файлом (симетрично з local-only-шляхом). Версія ПОЗАДУ реєстру — локаль
+  // відстала від уже опублікованого релізу, не порушення (нижче).
+  if (versionIsAhead(Vcurrent, Vpublished)) {
     fail(
-      `${label}: version у ${mf} (${Vcurrent}) розходиться з опублікованою (${Vpublished}) — ` +
-        `ручний bump заборонено. Відкоти version і поклади change-файл ` +
+      `${label}: version у ${mf} (${Vcurrent}) випереджає опубліковану (${Vpublished}) — ` +
+        `ручний bump поза CI заборонено. Відкоти version і поклади change-файл ` +
         `(npx @nitra/cursor change …); bump зробить CI на main (n-changelog.mdc)`
     )
     return
   }
+  if (compareSemverCore(Vcurrent, Vpublished) < 0) {
+    // Локаль ПОЗАДУ реєстру: CI вже опублікував новішу версію й закомітив bump назад,
+    // а ти ще не зробив `git pull`. Це не ручний bump (git не дасть запушити
+    // non-fast-forward), тож коміт не блокуємо — лише вимагаємо change-файл на наявні зміни.
+    pass(
+      `${label}: version у ${mf} (${Vcurrent}) позаду опублікованої (${Vpublished}) — ` +
+        `локаль відстала від реєстру (зроби git pull); це не ручний bump`
+    )
+    await checkPublishedWorkspacePendingGitChanges(manifest, Vcurrent, subWorkspaces, pass, fail, cwd)
+    return
+  }
   pass(`${label}: ${name}@${Vcurrent} збігається з реєстром — перевіряємо git на незрелізні зміни`)
   await checkPublishedWorkspacePendingGitChanges(manifest, Vcurrent, subWorkspaces, pass, fail, cwd)
 }
@@ -480,10 +536,11 @@ async function checkLocalOnlyChangedWorkspace(comparisonRef, manifest, baseLabel
   const label = workspaceLabel(manifest)
   const mf = manifestFilePath(manifest.ws, manifest)
   const Vcurrent = manifest.version
-  // Drift version від бази має пріоритет над change-файлом: ручний bump заборонено
-  // навіть якщо change-файл присутній (симетрично з published-шляхом).
+  // Лише drift УПЕРЕД (version > бази) має пріоритет над change-файлом: ручний bump
+  // заборонено навіть із change-файлом (симетрично з published-шляхом). Version позаду
+  // бази (гілка відстала від base-ref) — не порушення, не блокуємо.
   const Vbase = await readBaseVersion(comparisonRef, manifest, cwd)
-  if (Vbase !== null && Vcurrent !== null && Vbase !== Vcurrent) {
+  if (Vbase !== null && Vcurrent !== null && versionIsAhead(Vcurrent, Vbase)) {
     fail(
       `${label}: version у ${mf} змінено поза CI (${Vbase} → ${Vcurrent}) — ручний bump заборонено (на ${baseLabel} — ${Vbase}). ` +
         `Відкоти version і поклади change-файл (npx @nitra/cursor change …); bump зробить CI (n-changelog.mdc)`

package/rules/ci4/ci4.mdc

@@ -66,7 +66,7 @@ RAG витягує **фрагменти**, не цілі документи. Т
 docs/
 ├── adr/
 │   ├── <slug>.md                       # clean ADR-и (MADR v4 minimal, без frontmatter)
-│   ├── YYYYMMDD-HHMMSS-<sid>.md        # drafts (frontmatter session:/captured:/transcript:)
+│   ├── YYMMDD-HHMM-<sid>.md            # drafts (frontmatter session:/captured:/transcript:)
 │   └── index.md                        # autogen — список accepted ADR за датою
 ├── explanation/                        # Diátaxis: чому і що
 │   ├── overview.md                     # Capability Map (autogen)
@@ -86,7 +86,7 @@ docs/
 
 ## ADR як вхід проекцій
 
-Регенератор працює **тільки з clean ADR** (`docs/adr/<slug>.md`, без frontmatter, з рядком `**Status:** Accepted`). Drafts (`YYYYMMDD-HHMMSS-*.md`) ігноруються — їх перетворить у clean ADR `normalize-decisions.sh` із правила `adr`.
+Регенератор працює **тільки з clean ADR** (`docs/adr/<slug>.md`, без frontmatter, з рядком `**Status:** Accepted`). Drafts (`YYMMDD-HHMM-*.md`) ігноруються — їх перетворить у clean ADR `normalize-decisions.sh` із правила `adr`.
 
 Поля, які регенератор читає з clean ADR:
 

package/rules/js-run/js/runtime.mjs

@@ -26,6 +26,8 @@
  *  - «Паузи через setTimeout»: `new Promise(resolve => setTimeout(resolve, ms))` (з/без `await`)
  *    треба замінити на `await setTimeout(ms)` з `node:timers/promises`
  *    (див. `utils/promise-settimeout-scan.mjs`);
+ *  - «Temporal у Bun runtime»: identifier `Temporal` заборонений, бо поточний Bun runtime
+ *    не має глобального Temporal API (див. `utils/temporal-scan.mjs`);
  *  - «jsconfig.json»: у backend-пакеті з каталогом `src/` у корені має бути `jsconfig.json`,
  *    вміст якого збігається з каноном js-run.mdc (NodeNext і include на дерево `src`).
  *
@@ -50,6 +52,7 @@ import {
 } from '../lib/conn-imports-scan.mjs'
 import { loadCursorIgnorePaths } from '../../../scripts/lib/load-cursor-config.mjs'
 import { findPromiseSetTimeoutInText, isPromiseSetTimeoutScanSourceFile } from '../lib/promise-settimeout-scan.mjs'
+import { findTemporalUsageInText, isTemporalScanSourceFile } from '../lib/temporal-scan.mjs'
 import { walkDir } from '../../../scripts/utils/walkDir.mjs'
 import { getMonorepoPackageRootDirs } from '../../../scripts/lib/workspaces.mjs'
 
@@ -313,6 +316,30 @@ async function checkPromiseSetTimeoutPause(absPackageRoot, sourcePaths, label, f
   return violations
 }
 
+/**
+ * Сканує джерела пакета на `Temporal`, який у Bun runtime ще недоступний.
+ * @param {string} absPackageRoot абсолютний корінь пакета
+ * @param {string[]} sourcePaths абсолютні шляхи до файлів
+ * @param {string} label префікс повідомлення `[<pkg>] `
+ * @param {(msg: string) => void} fail callback при помилці
+ * @returns {Promise<number>} кількість порушень
+ */
+async function checkTemporalUsage(absPackageRoot, sourcePaths, label, fail) {
+  let violations = 0
+  for (const absPath of sourcePaths) {
+    const rel = relPosix(absPackageRoot, absPath)
+    if (!isTemporalScanSourceFile(rel)) continue
+    const content = await readFile(absPath, 'utf8')
+    for (const v of findTemporalUsageInText(content, rel)) {
+      violations++
+      fail(
+        `${label}${rel}:${v.line} — Temporal API заборонений у Bun runtime; використовуй Date або інʼєктований timestamp`
+      )
+    }
+  }
+  return violations
+}
+
 /**
  * Перевіряє відповідність правилам js-run.mdc для одного workspace-пакета.
  * @param {string} rootDir відносний шлях workspace (не `'.'`)
@@ -371,6 +398,11 @@ async function checkWorkspacePackage(rootDir, ignorePaths, fail, passFn, cwd) {
     passFn(`${label}немає 'new Promise(r => setTimeout(r, ms))' — паузи через 'node:timers/promises'`)
   }
 
+  const temporalViolations = await checkTemporalUsage(absPackageRoot, sourcePaths, label, fail)
+  if (temporalViolations === 0) {
+    passFn(`${label}немає Temporal API у Bun runtime-коді`)
+  }
+
   checkOtelConfigmap(rootDir, passFn, cwd)
 }
 

package/rules/js-run/js-run.mdc

@@ -30,6 +30,12 @@ version: '1.11'
 
 Це **не** стосується поля `engines.node` (мінімальна версія Node для сумісності інструментів) і **не** стосується frontend-пакетів з `vite` у `devDependencies`.
 
+## Temporal API
+
+У backend/Bun runtime-коді **не використовуй `Temporal`** (`Temporal.Now`, `Temporal.Instant`, імпорти з polyfill тощо). Поточний Bun runtime ще не має глобального `Temporal` (`typeof Temporal === "undefined"`), тому агентам треба лишатися на сумісному `Date` API або передавати timestamp у чисті функції через параметр.
+
+Перевірка `npx @nitra/cursor fix js-run` сканує JS/TS AST і падає на identifier `Temporal` у backend workspace-коді.
+
 Канон заборонених патернів у `scripts`: [package.json.deny.json](./policy/package_json/template/package.json.deny.json) (`scriptsForbidden`).
 
 ## Структура проекту

package/rules/js-run/lib/temporal-scan.mjs

@@ -0,0 +1,52 @@
+/**
+ * AST-сканер заборони `Temporal` у Bun runtime-коді.
+ *
+ * Bun 1.3.x ще не має глобального `Temporal`, тому правило js-run забороняє
+ * будь-який identifier `Temporal` у backend workspace-коді. Заборона свідомо
+ * охоплює polyfill/import-сценарії: у цьому репозиторії канон для часу лишається
+ * через `Date` або ін'єкцію timestamp у чисті функції.
+ */
+import {
+  normalizeSnippet,
+  offsetToLine,
+  parseProgramOrNull,
+  walkAstWithAncestors
+} from '../../../scripts/utils/ast-scan-utils.mjs'
+
+const SOURCE_FILE_RE = /\.([cm]?[jt]sx?)$/u
+
+/**
+ * Знаходить використання identifier `Temporal` у тексті.
+ * @param {string} content вихідний код
+ * @param {string} [virtualPath] шлях для вибору `lang` (наприклад `pkg/src/foo.ts`)
+ * @returns {{ line: number, snippet: string }[]} список порушень
+ */
+export function findTemporalUsageInText(content, virtualPath = 'scan.ts') {
+  const program = parseProgramOrNull(content, virtualPath)
+  if (!program) return []
+  /** @type {{ line: number, snippet: string }[]} */
+  const out = []
+  /** @type {Set<string>} */
+  const seen = new Set()
+  walkAstWithAncestors(program, [], node => {
+    if (node.type !== 'Identifier' || node.name !== 'Temporal') return
+    const key = `${node.start}:${node.end}`
+    if (seen.has(key)) return
+    seen.add(key)
+    out.push({
+      line: offsetToLine(content, node.start),
+      snippet: normalizeSnippet(content.slice(node.start, node.end))
+    })
+  })
+  return out
+}
+
+/**
+ * Чи сканувати цей файл за розширенням (JS/TS-сім'я, виключно з `.d.ts`).
+ * @param {string} relativePath відносний шлях до файлу
+ * @returns {boolean} `true`, якщо розширення підходить для сканування
+ */
+export function isTemporalScanSourceFile(relativePath) {
+  if (!SOURCE_FILE_RE.test(relativePath)) return false
+  return !relativePath.endsWith('.d.ts')
+}

package/rules/npm-module/js/skill_meta.mjs

@@ -4,6 +4,8 @@
  * Кожен `npm/skills/<id>/` має містити валідний `meta.json`:
  *  - `worktree` присутнє і boolean;
  *  - `auto` (якщо присутнє) — розпізнане (`"завжди"` або непорожній масив рядків);
+ *  - `requireRoot` (якщо присутнє) — boolean; не може бути `false` при `worktree:true`
+ *    (worktree вже вимагає кореня — суперечність вводить в оману);
  *  - залишковий `auto.md` заборонено (міграція на meta.json завершена).
  *
  * Концерн застосовний лише в репо самого пакета (де є `npm/skills/`); у споживача
@@ -52,6 +54,16 @@ export function check(cwd = process.cwd()) {
       reporter.fail(`skills/${id}: meta.json.auto нерозпізнане — очікується "завжди" або непорожній масив правил`)
       skillOk = false
     }
+    if (raw.requireRoot !== undefined && typeof raw.requireRoot !== 'boolean') {
+      reporter.fail(`skills/${id}: meta.json.requireRoot має бути boolean`)
+      skillOk = false
+    }
+    if (raw.worktree === true && raw.requireRoot === false) {
+      reporter.fail(
+        `skills/${id}: requireRoot:false суперечить worktree:true (worktree вже вимагає кореня — прибери поле)`
+      )
+      skillOk = false
+    }
     if (skillOk) {
       reporter.pass(`skills/${id}: meta.json валідний`)
     }

package/rules/release/change.mjs

@@ -1,11 +1,40 @@
 /**
- * `n-cursor change` — пише один change-файл `<ws>/.changes/<timestamp>-<rand>.md`.
+ * `n-cursor change` — пише один change-файл `<ws>/.changes/YYMMDD-HHMM.md`.
+ * Якщо файл за ту саму хвилину вже існує, додає `-2`, `-3` тощо.
  * Замінює ручне редагування CHANGELOG у feature-флоу (n-changelog.mdc v3.0).
  */
 import { mkdir, writeFile } from 'node:fs/promises'
 import { join } from 'node:path'
 
-import { CHANGES_DIR, newChangeFileName, parseChangeFile, serializeChangeFile } from './lib/change-file.mjs'
+import { CHANGES_DIR, changeFileName, parseChangeFile, serializeChangeFile } from './lib/change-file.mjs'
+
+/**
+ * @param {unknown} error помилка `writeFile`
+ * @returns {boolean} true, якщо файл уже існує
+ */
+function isFileExistsError(error) {
+  return error instanceof Error && 'code' in error && error.code === 'EEXIST'
+}
+
+/**
+ * Записує change-файл create-only, додаючи числовий suffix лише при локальній колізії.
+ * @param {string} dir абсолютний шлях до `.changes`
+ * @param {string} content вміст change-файлу
+ * @param {number} timestamp epoch milliseconds
+ * @returns {Promise<string>} створене ім'я файла
+ */
+async function writeUniqueChangeFile(dir, content, timestamp) {
+  for (let sequence = 1; ; sequence++) {
+    const name = changeFileName(timestamp, sequence)
+    try {
+      await writeFile(join(dir, name), content, { flag: 'wx' })
+      return name
+    } catch (error) {
+      if (isFileExistsError(error)) continue
+      throw error
+    }
+  }
+}
 
 /**
  * @param {object} params параметри
@@ -14,9 +43,10 @@ import { CHANGES_DIR, newChangeFileName, parseChangeFile, serializeChangeFile }
  * @param {string} params.message опис
  * @param {string} [params.ws] workspace (за замовчуванням `.`)
  * @param {string} [params.cwd] корінь
+ * @param {number} [params.timestamp] epoch milliseconds для детермінованих тестів
  * @returns {Promise<string>} відносний шлях створеного файлу (від ws)
  */
-export async function writeChange({ bump, section, message, ws = '.', cwd = process.cwd() }) {
+export async function writeChange({ bump, section, message, ws = '.', cwd = process.cwd(), timestamp = Date.now() }) {
   const description = (message ?? '').trim()
   const content = serializeChangeFile({ bump, section, description })
   // Валідація полів: parseChangeFile кидає зрозумілу помилку на невалідних bump/section/порожньому описі.
@@ -24,8 +54,7 @@ export async function writeChange({ bump, section, message, ws = '.', cwd = proc
 
   const dir = join(cwd, ws, CHANGES_DIR)
   await mkdir(dir, { recursive: true })
-  const name = newChangeFileName()
-  await writeFile(join(dir, name), content)
+  const name = await writeUniqueChangeFile(dir, content, timestamp)
   return join(CHANGES_DIR, name)
 }
 

package/rules/release/lib/change-file.mjs

@@ -1,10 +1,10 @@
 /**
- * Один change-файл `<ws>/.changes/<timestamp>-<rand>.md`: YAML-подібний frontmatter
+ * Один change-файл `<ws>/.changes/YYMMDD-HHMM.md`: YAML-подібний frontmatter
  * із двома ключами (`bump`, `section`) + текст опису. Парсер мінімальний — лише ці два
- * ключі, без зовнішніх залежностей.
+ * ключі, без зовнішніх залежностей. Якщо файл за ту саму хвилину вже існує, writer додає
+ * числовий suffix (`-2`, `-3`) атомарним create-only записом.
  */
 
-import { randomBytes } from 'node:crypto'
 import { existsSync } from 'node:fs'
 import { readdir, readFile } from 'node:fs/promises'
 import { join } from 'node:path'
@@ -65,21 +65,36 @@ export function serializeChangeFile(entry) {
 export const CHANGES_DIR = '.changes'
 
 /**
- * @param {number} timestamp `Date.now()`
- * @param {string} suffix короткий випадковий суфікс (hex)
- * @returns {string} `<timestamp>-<suffix>.md`
+ * @param {number} timestamp epoch milliseconds
+ * @returns {string} local timestamp prefix `YYMMDD-HHMM`
  */
-export function changeFileName(timestamp, suffix) {
-  return `${timestamp}-${suffix}.md`
+function formatChangeTimestamp(timestamp) {
+  const d = new Date(timestamp)
+  const yy = String(d.getFullYear()).slice(-2)
+  const month = String(d.getMonth() + 1).padStart(2, '0')
+  const day = String(d.getDate()).padStart(2, '0')
+  const hour = String(d.getHours()).padStart(2, '0')
+  const minute = String(d.getMinutes()).padStart(2, '0')
+  return `${yy}${month}${day}-${hour}${minute}`
 }
 
 /**
- * Унікальне ім'я для нового change-файлу: timestamp (порядок) + rand (анти-колізія
- * для паралельних агентів у різних worktree, що пишуть у ту саму мілісекунду).
+ * @param {number} timestamp epoch milliseconds
+ * @param {number} [sequence] collision sequence; `1`/omitted has no suffix
+ * @returns {string} `YYMMDD-HHMM.md` or `YYMMDD-HHMM-<n>.md`
+ */
+export function changeFileName(timestamp, sequence = 1) {
+  const base = formatChangeTimestamp(timestamp)
+  return sequence > 1 ? `${base}-${sequence}.md` : `${base}.md`
+}
+
+/**
+ * Базове ім'я для нового change-файлу. Унікальність забезпечує writer: він спершу
+ * пробує `YYMMDD-HHMM.md`, а suffix додає лише при локальному `EEXIST`.
  * @returns {string} результат
  */
 export function newChangeFileName() {
-  return changeFileName(Date.now(), randomBytes(3).toString('hex'))
+  return changeFileName(Date.now())
 }
 
 /**

package/scripts/lib/assert-project-root.mjs

@@ -50,15 +50,22 @@ function safeRealpath(dir) {
 
 /**
  * Кидає помилку, якщо `dir` — піддиректорія git-репозиторію (тобто не його
- * корінь). Поза git-репо (немає toplevel) — пропускає без помилки.
+ * корінь). Поза git-репо (немає toplevel) — пропускає без помилки. У git-worktree
+ * (`.worktrees/<branch>/`) toplevel = корінь самого worktree, тож запуск із нього
+ * проходить — гард ловить лише старт із піддиректорії робочого дерева.
  *
- * Викликати лише перед дефолтним sync (до перших мутацій файлів), не для
+ * Викликати перед мутаційними діями (default sync, `fix`, `lint`, `coverage`,
+ * `change`, `release`), які скаффолдять / переписують файли в CWD. Не для
  * підкоманд із власним `--root` чи read-only-логікою.
  * @param {string} [dir] каталог, що перевіряємо (типово `cwd()`)
+ * @param {string} [action] людинозрозумілий опис дії для тексту помилки
  * @throws {Error} коли `dir` всередині git-репо, але не його корінь
  * @returns {void}
  */
-export function assertCwdIsProjectRoot(dir = cwd()) {
+export function assertCwdIsProjectRoot(
+  dir = cwd(),
+  action = 'Команда @nitra/cursor мутує проєкт у поточному каталозі'
+) {
   const top = gitToplevel(dir)
   if (top === null) return
   const here = safeRealpath(dir)
@@ -67,8 +74,7 @@ export function assertCwdIsProjectRoot(dir = cwd()) {
     `❌ @nitra/cursor запущено не в корені проєкту.\n` +
       `   Поточний каталог: ${here}\n` +
       `   Корінь git-репо:  ${top}\n` +
-      `   Дефолтна синхронізація скаффолдить .cursor/, .claude/, CLAUDE.md, .n-cursor.json\n` +
-      `   і робить bun install у поточному каталозі — із піддиректорії це розкидало б\n` +
-      `   конфіг не туди. Перейдіть у корінь репозиторію: cd ${top}`
+      `   ${action} — із піддиректорії це зачепило б не той каталог.\n` +
+      `   Перейдіть у корінь репозиторію: cd ${top}`
   )
 }

package/scripts/lib/root-notice.mjs

@@ -0,0 +1,64 @@
+/**
+ * Вшивання root-guard preflight у синкнутий `SKILL.md` для скілів, що **мутують
+ * проєкт у поточному каталозі**, але виконуються **in-place** (без worktree-
+ * ізоляції) — `meta.json` → `requireRoot: true` і `worktree: false`.
+ *
+ * Worktree-скіли (`worktree: true`) свій root-assert уже мають у worktree-блоці
+ * (`worktree-notice.mjs`): корінь worktree = його toplevel. Цей модуль — для
+ * не-worktree-кейсу (напр. `n-start-check`, що прогоняє `start` усіх воркспейсів
+ * у місці й має стартувати з кореня монорепо).
+ *
+ * Блок — інструкція агенту, що читає `SKILL.md`; вставляється між стабільними
+ * маркерами, ре-синк ідемпотентний: наявний блок замінюється, при `false` —
+ * видаляється. Програмний аналог для CLI-команд — `assertCwdIsProjectRoot`.
+ */
+
+/** Маркер початку root-блоку. */
+export const ROOT_START = '<!-- n-cursor:root:start -->'
+/** Маркер кінця root-блоку. */
+export const ROOT_END = '<!-- n-cursor:root:end -->'
+
+/** Наявний блок разом із сусідніми порожніми рядками (для чистого видалення). */
+const BLOCK_RE = /\n*<!-- n-cursor:root:start -->[\s\S]*?<!-- n-cursor:root:end -->\n*/u
+
+/** Закриття YAML-frontmatter на початку файла. */
+const FRONTMATTER_RE = /^(---\n[\s\S]*?\n---\n)/u
+
+/** Тіло root-guard інструкції. */
+const NOTICE_BODY = `> [!IMPORTANT]
+> **Root-only skill.** Скіл мутує проєкт у поточному каталозі й має запускатися **з кореня репозиторію**.
+
+**Крок 0 — preflight (обовʼязковий, перед будь-якими іншими діями).**
+
+\`\`\`bash
+pwd
+git rev-parse --show-toplevel
+\`\`\`
+
+Якщо \`pwd\` **не** збігається з виводом \`git rev-parse --show-toplevel\` — ти в **піддиректорії**. **STOP**: перейди в корінь (\`cd <toplevel>\`, literal-шлях із виводу) і лише тоді виконуй наступні кроки скіла. Поза git-репо (команда без виводу) — продовжуй (корінь визначити неможливо).`
+
+/** Канонічний блок root-інструкції (з маркерами). */
+const BLOCK = `${ROOT_START}\n${NOTICE_BODY}\n${ROOT_END}`
+
+/**
+ * Вставляє / оновлює / видаляє root-guard блок у вмісті `SKILL.md`.
+ * @param {string} content вміст `SKILL.md`
+ * @param {boolean} enabled чи має бути блок (`requireRoot && !worktree`)
+ * @returns {string} оновлений вміст (ідемпотентно)
+ */
+export function injectRootNotice(content, enabled) {
+  const hadBlock = content.includes(ROOT_START)
+  const withoutBlock = content.replace(BLOCK_RE, '\n\n')
+
+  if (!enabled) {
+    return hadBlock ? withoutBlock : content
+  }
+
+  const fm = withoutBlock.match(FRONTMATTER_RE)
+  if (fm) {
+    const head = fm[1]
+    const rest = withoutBlock.slice(head.length).replace(/^\n+/u, '')
+    return `${head}\n${BLOCK}\n\n${rest}`
+  }
+  return `${BLOCK}\n\n${withoutBlock.replace(/^\n+/u, '')}`
+}

package/scripts/lib/skill-meta.mjs

@@ -3,10 +3,14 @@
  *
  * `meta.json` — єдине джерело правди для скіла замість колишнього `auto.md`:
  *  - `auto` — умова автоактивації (`"завжди"` | масив id правил), опційне;
- *  - `worktree` — boolean: чи виконувати скіл в окремому git-worktree (один інстанс).
+ *  - `worktree` — boolean: чи виконувати скіл в окремому git-worktree (один інстанс);
+ *  - `requireRoot` — boolean, опційне: чи скіл вимагає запуску з кореня репо.
+ *    Worktree-скіли (`worktree:true`) вимагають кореня неявно (корінь worktree =
+ *    його toplevel), тож для них поле зайве. Явний `requireRoot:true` — для
+ *    in-place скілів, що мутують CWD без worktree-ізоляції (напр. `n-start-check`).
  *
  * Цим хелпером користуються `auto-skills.mjs` (автоактивація), `n-cursor.js`
- * (sync + вшивання worktree-блоку) і check-концерн `npm-module/js/skill_meta.mjs`,
+ * (sync + вшивання worktree/root-блоку) і check-концерн `npm-module/js/skill_meta.mjs`,
  * щоб не дублювати парсинг і форму валідації.
  */
 import { existsSync, readFileSync } from 'node:fs'
@@ -36,6 +40,16 @@ export function parseSkillAutoSpec(value) {
   return null
 }
 
+/**
+ * Чи вимагає скіл запуску з кореня репо («активовано root-захист»). Єдина похідна
+ * ознака: `worktree:true` (корінь гарантує worktree) АБО явний `requireRoot:true`.
+ * @param {Record<string, unknown> | null} meta розпарсений `meta.json` (або null)
+ * @returns {boolean} true — скіл мутує проєкт і має стартувати з кореня
+ */
+export function skillRequiresRoot(meta) {
+  return meta?.worktree === true || meta?.requireRoot === true
+}
+
 /**
  * Читає й парсить `meta.json` одного скіла.
  * @param {string} skillDir абсолютний шлях до каталогу скіла

package/scripts/lib/worktree-notice.mjs

@@ -18,66 +18,65 @@
  */
 
 /** Маркер початку worktree-блоку (стабільний, не залежить від тексту всередині). */
-export const WORKTREE_START = "<!-- n-cursor:worktree:start -->";
+export const WORKTREE_START = '<!-- n-cursor:worktree:start -->'
 /** Маркер кінця worktree-блоку. */
-export const WORKTREE_END = "<!-- n-cursor:worktree:end -->";
+export const WORKTREE_END = '<!-- n-cursor:worktree:end -->'
 
-const FALLBACK_SUFFIX = "task";
+const FALLBACK_SUFFIX = 'task'
 
 /** Наявний блок разом із сусідніми порожніми рядками (для чистого видалення). */
-const BLOCK_RE =
-  /\n*<!-- n-cursor:worktree:start -->[\s\S]*?<!-- n-cursor:worktree:end -->\n*/u;
+const BLOCK_RE = /\n*<!-- n-cursor:worktree:start -->[\s\S]*?<!-- n-cursor:worktree:end -->\n*/u
 
 /** Закриття YAML-frontmatter на початку файла. */
-const FRONTMATTER_RE = /^(---\n[\s\S]*?\n---\n)/u;
+const FRONTMATTER_RE = /^(---\n[\s\S]*?\n---\n)/u
 
 /** Значення `name` з YAML-frontmatter. */
-const NAME_RE = /^name:\s*["']?([^"'\n]+)["']?\s*$/mu;
+const NAME_RE = /^name:\s*["']?([^"'\n]+)["']?\s*$/mu
 
 /** Перший H1 як fallback, якщо frontmatter не містить `name`. */
-const H1_RE = /^#\s+(.+)$/mu;
+const H1_RE = /^#\s+(.+)$/mu
 
 const CYRILLIC_TRANSLIT = new Map(
   Object.entries({
-    а: "a",
-    б: "b",
-    в: "v",
-    г: "h",
-    ґ: "g",
-    д: "d",
-    е: "e",
-    є: "ye",
-    ж: "zh",
-    з: "z",
-    и: "y",
-    і: "i",
-    ї: "yi",
-    й: "y",
-    к: "k",
-    л: "l",
-    м: "m",
-    н: "n",
-    о: "o",
-    п: "p",
-    р: "r",
-    с: "s",
-    т: "t",
-    у: "u",
-    ф: "f",
-    х: "kh",
-    ц: "ts",
-    ч: "ch",
-    ш: "sh",
-    щ: "shch",
-    ь: "",
-    ю: "yu",
-    я: "ya",
-    ы: "y",
-    э: "e",
-    ё: "yo",
-    ъ: "",
-  }),
-);
+    а: 'a',
+    б: 'b',
+    в: 'v',
+    г: 'h',
+    ґ: 'g',
+    д: 'd',
+    е: 'e',
+    є: 'ye',
+    ж: 'zh',
+    з: 'z',
+    и: 'y',
+    і: 'i',
+    ї: 'yi',
+    й: 'y',
+    к: 'k',
+    л: 'l',
+    м: 'm',
+    н: 'n',
+    о: 'o',
+    п: 'p',
+    р: 'r',
+    с: 's',
+    т: 't',
+    у: 'u',
+    ф: 'f',
+    х: 'kh',
+    ц: 'ts',
+    ч: 'ch',
+    ш: 'sh',
+    щ: 'shch',
+    ь: '',
+    ю: 'yu',
+    я: 'ya',
+    ы: 'y',
+    э: 'e',
+    ё: 'yo',
+    ъ: ''
+  })
+)
 
 /**
  * Транслітерує кирилицю в ASCII для короткого suffix.
@@ -85,8 +84,7 @@ const CYRILLIC_TRANSLIT = new Map(
  * @returns {string} транслітерований текст
  */
 function transliterate(value) {
-  return Array.from(value.toLowerCase(), (char) => CYRILLIC_TRANSLIT.get(char) ?? char)
-    .join("");
+  return Array.from(value.toLowerCase(), char => CYRILLIC_TRANSLIT.get(char) ?? char).join('')
 }
 
 /**
@@ -95,20 +93,16 @@ function transliterate(value) {
  * @returns {string} suffix до 10 символів
  */
 function deriveSuffix(content) {
-  const raw =
-    content.match(NAME_RE)?.[1] ?? content.match(H1_RE)?.[1] ?? FALLBACK_SUFFIX;
+  const raw = content.match(NAME_RE)?.[1] ?? content.match(H1_RE)?.[1] ?? FALLBACK_SUFFIX
   const slug = transliterate(raw)
     .trim()
-    .replace(/^n-/u, "")
-    .normalize("NFKD")
-    .replaceAll(/[\u0300-\u036F]/gu, "")
-    .replaceAll(/[^a-z0-9]+/gu, "-")
-    .replaceAll(/^-+|-+$/gu, "");
-
-  return (
-    (slug || FALLBACK_SUFFIX).slice(0, 10).replace(/-+$/u, "") ||
-    FALLBACK_SUFFIX
-  );
+    .replace(/^n-/u, '')
+    .normalize('NFKD')
+    .replaceAll(/[\u0300-\u036F]/gu, '')
+    .replaceAll(/[^a-z0-9]+/gu, '-')
+    .replaceAll(/^-+|-+$/gu, '')
+
+  return (slug || FALLBACK_SUFFIX).slice(0, 10).replace(/-+$/u, '') || FALLBACK_SUFFIX
 }
 
 /**
@@ -123,11 +117,14 @@ function buildNoticeBody(suffix) {
 **Крок 0 — preflight (обовʼязковий, перед будь-якими іншими діями).** Якщо перевірка падає — **STOP**: не питай користувача про назву гілки, а сам створи worktree від поточної гілки за конвенцією \`<current-branch>-${suffix}\`. Суфікс \`${suffix}\` — коротка (до 10 символів) транслітерація задачі. Не виконуй **жоден** наступний крок скіла, поки preflight не завершився успіхом.
 
 \`\`\`bash
+pwd
 git rev-parse --show-toplevel
 git branch --show-current
 \`\`\`
 
-Якщо перша команда показала, що ти **не** в \`.worktrees/\`, візьми вивід другої команди як \`<current-branch>\` і виконай **literal-команди без shell expansion** (без command substitution, variable expansion чи backticks). Наприклад, якщо поточна гілка \`feature/x\`:
+**Root-assert.** Якщо \`pwd\` **не** збігається з виводом \`git rev-parse --show-toplevel\` — ти в **піддиректорії** робочого дерева (worktree-шляхи нижче відносні до кореня репо). Спершу перейди в корінь: \`cd <toplevel>\` (literal-шлях із виводу), і лише тоді продовжуй preflight. Не створюй worktree з піддиректорії — \`cd .worktrees/<…>\` звідти впаде.
+
+Якщо \`git rev-parse --show-toplevel\` показав, що ти **не** в \`.worktrees/\`, візьми вивід \`git branch --show-current\` як \`<current-branch>\` і виконай **literal-команди без shell expansion** (без command substitution, variable expansion чи backticks). Наприклад, якщо поточна гілка \`feature/x\`:
 
 \`\`\`bash
 npx @nitra/cursor worktree add "feature/x-${suffix}" "n-${suffix}: worktree-only skill"
@@ -175,7 +172,7 @@ n_cursor_npx() {
 }
 \`\`\`
 
-Усі подальші bootstrap-виклики \`npx @nitra/cursor <cmd>\` у цій сесії роби через \`n_cursor_npx <cmd>\`. Якщо опинився у свіжому shell без цієї функції — спершу повтори блок вище (\`bun install\` + визначення \`n_cursor_npx\`).`;
+Усі подальші bootstrap-виклики \`npx @nitra/cursor <cmd>\` у цій сесії роби через \`n_cursor_npx <cmd>\`. Якщо опинився у свіжому shell без цієї функції — спершу повтори блок вище (\`bun install\` + визначення \`n_cursor_npx\`).`
 }
 
 /**
@@ -184,7 +181,7 @@ n_cursor_npx() {
  * @returns {string} текст блоку від START до END
  */
 function buildBlock(content) {
-  return `${WORKTREE_START}\n${buildNoticeBody(deriveSuffix(content))}\n${WORKTREE_END}`;
+  return `${WORKTREE_START}\n${buildNoticeBody(deriveSuffix(content))}\n${WORKTREE_END}`
 }
 
 /**
@@ -194,19 +191,19 @@ function buildBlock(content) {
  * @returns {string} оновлений вміст (ідемпотентно)
  */
 export function injectWorktreeNotice(content, enabled) {
-  const hadBlock = content.includes(WORKTREE_START);
-  const withoutBlock = content.replace(BLOCK_RE, "\n\n");
+  const hadBlock = content.includes(WORKTREE_START)
+  const withoutBlock = content.replace(BLOCK_RE, '\n\n')
 
   if (!enabled) {
-    return hadBlock ? withoutBlock : content;
+    return hadBlock ? withoutBlock : content
   }
 
-  const block = buildBlock(withoutBlock);
-  const fm = withoutBlock.match(FRONTMATTER_RE);
+  const block = buildBlock(withoutBlock)
+  const fm = withoutBlock.match(FRONTMATTER_RE)
   if (fm) {
-    const head = fm[1];
-    const rest = withoutBlock.slice(head.length).replace(/^\n+/u, "");
-    return `${head}\n${block}\n\n${rest}`;
+    const head = fm[1]
+    const rest = withoutBlock.slice(head.length).replace(/^\n+/u, '')
+    return `${head}\n${block}\n\n${rest}`
   }
-  return `${block}\n\n${withoutBlock.replace(/^\n+/u, "")}`;
+  return `${block}\n\n${withoutBlock.replace(/^\n+/u, '')}`
 }

package/scripts/sync-claude-config.mjs

@@ -21,8 +21,8 @@
  *   entries додаються, коли правило `adr` увімкнене, і видаляються, коли вимкнене.
  * - `.gitignore` — **merge** (лише з `adr`): дописує відсутні рядки з канонічного
  *   фрагмента `rules/adr/js/hooks/template/.gitignore.snippet` (`node_modules/`, `dist/`,
- *   `*.secret`, логи capture/normalize, `.normalize-state`, `.normalize.lock`); існуючі
- *   рядки не перезаписуються.
+ *   `*.secret`, логи capture/normalize, `.normalize-state`, `.normalize.lock`,
+ *   `.claude/scheduled_tasks.lock`); існуючі рядки не перезаписуються.
  *
  * Опт-аут — `claude-config: false` у `.n-cursor.json`.
  */

package/skills/llm-patch/meta.json

@@ -1 +1 @@
-{ "auto": "завжди", "worktree": false }
+{ "auto": "завжди", "worktree": false, "requireRoot": false }

package/skills/publish-telegram/meta.json

@@ -1 +1 @@
-{ "auto": "завжди", "worktree": false }
+{ "auto": "завжди", "worktree": false, "requireRoot": false }

package/skills/start-check/meta.json

@@ -1 +1 @@
-{ "auto": "завжди", "worktree": false }
+{ "auto": "завжди", "worktree": false, "requireRoot": true }

package/skills/worktree/meta.json

@@ -1 +1 @@
-{ "auto": "завжди", "worktree": false }
+{ "auto": "завжди", "worktree": false, "requireRoot": false }