@bonesofspring/ai-rules 0.1.33 → 0.1.35

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bonesofspring/ai-rules",
-  "version": "0.1.33",
+  "version": "0.1.35",
   "description": "Presets of Cursor and Claude rules/commands for Revy Ross personal use",
   "license": "MIT",
   "author": "Revy Ross",

package/presets/cursor/next/rules/README.md

@@ -11,10 +11,19 @@
 
 - То есть .mdc = “markdown + config для Cursor”, .md = просто текст без управляющего смысла для ассистента.
 
+### С чего начать новую фичу
+
+См. **`feature-delivery-workflow.mdc`** (сквозной чеклист слоёв и матрица «зона репозитория → какое правило перечитать»).
+
+### Эталонные фичи (заполняет команда)
+
+Имена папок в `app/src/ui/pages/**`, `app/src/store/slices/**`, `app/src/api/services/**`, которые считаются образцом структуры — **TBD** (заменить на реальные пути после договорённости в команде).
+
 ### Каталог ключевых правил
 
 | Файл | Назначение |
 |------|------------|
+| `feature-delivery-workflow.mdc` | Сквозной порядок работ по фиче, mermaid‑поток, матрица слой → правило `.mdc` |
 | `next-app-core.mdc` | Стек, слои, порты‑адаптеры (кратко), доменная логика vs state, общие требования к агенту и линтам |
 | `architecture-boundaries.mdc` | Границы UI / store / API, импорты (`@/types` по `types-public-imports`), UI→services, порты‑адаптеры, фича как срез |
 | `http-client.mdc` | Один HTTP‑стек, контракты из `@/types`, без разбросанного низкоуровневого API |

package/presets/cursor/next/rules/arrow-functions.mdc

@@ -0,0 +1,45 @@
+---
+description: Предпочитать стрелочные функции при написании кода
+alwaysApply: true
+---
+
+# Стрелочные функции
+
+При разработке **использовать стрелочный синтаксис** для функций, где это допустимо в TypeScript/JavaScript.
+
+## Что делать
+
+- Объявлять функции как **`const имя = (...) => { ... }`** вместо **`function имя(...) { ... }`**, если не нужны особенности объявления `function`.
+- Колбэки и обработчики — стрелочные функции: `.map((x) => ...)`, `onClick={() => ...}`.
+- React-компоненты и хуки — как стрелочные функции с явной типизацией пропсов/возврата по принятому в проекте стилю.
+
+## Исключения (допустимо не стрелка)
+
+- **Генераторы** (`function*`) — стрелкой не выразить.
+- **Методы класса** — если в коде используются классы, допустимы обычные методы (`method() {}`), а не стрелки в теле класса (из‑за `this`).
+- Когда осознанно нужны **подъём (hoisting)** или **имя функции в стеке** только у `function` — редкие случаи; иначе предпочитать стрелку.
+
+## Примеры
+
+```typescript
+// ❌ Избегать для нового кода
+function formatLabel(id: string): string {
+  return id.toUpperCase()
+}
+
+// ✅ Предпочтительно
+const formatLabel = (id: string): string => {
+  return id.toUpperCase()
+}
+```
+
+```tsx
+// ✅ Предпочтительно
+const UserCard = ({ name }: { name: string }) => {
+  return <span>{name}</span>
+}
+```
+
+## Требование к агенту
+
+При генерации и правке кода **по умолчанию выбирать стрелочные функции**; отступать к `function` только в случаях из раздела исключений.

package/presets/cursor/next/rules/feature-delivery-workflow.mdc

@@ -0,0 +1,53 @@
+---
+description: Сквозной чеклист новой фичи и матрица «слой → правило Cursor»
+alwaysApply: true
+---
+
+# Доставка фичи (сквозной порядок)
+
+Типичная фича с данными с backend и общим состоянием. Детали слоёв — в `architecture-boundaries.mdc`, `next-app-core.mdc`.
+
+## Чеклист (порядок работ)
+
+1. **Доменные типы** — `app/src/types/**`, экспорт через barrel `app/src/types/index.ts` (`types-public-imports.mdc`); JSDoc полей — `types-jsdoc.mdc`.
+2. **Контракт API** — DTO ответов/запросов там, где принято в репо; целевые доменные типы в `@/types`.
+3. **Мапперы** — DTO → домен в `*responseMappers.ts` или аналоге; чистые функции (`api-services.mdc`).
+4. **Сервисы** — вызовы только через прикладные клиенты `app/src/api/clients/**`, public API модуля (`api-services.mdc`, `http-client.mdc`). Без `fetch` из UI/store.
+5. **Состояние** — `createSlice` / `createAsyncThunk`, доменные модели в state (`store-rtk.mdc`); thunk вызывает сервисы из `@/api/services/**`.
+6. **UI** — тонкие компоненты, типы из `@/types`, без DTO (`react-ui.mdc`, `architecture-boundaries.mdc`, `no-props-spread.mdc`).
+7. **Моки** — по схеме репозитория, точка входа регистрации моков (например `app/src/mocks/index.js`).
+8. **Тесты** — unit для мапперов и критичной логики (`tests-unit.mdc`); при смене HTTP‑клиента — behavior‑тесты клиента (`http-client.mdc`); e2e по `*.cases.md` (`tests-e2e-structure.mdc`, `playwright-agents.mdc`).
+9. **Завершение** — из каталога `app/`: `yarn lint:js`, при стилях `yarn lint:css`, `yarn type-check` (`next-app-core.mdc`).
+
+## Поток данных (ориентир)
+
+```mermaid
+flowchart LR
+  subgraph transport [Транспорт]
+    HttpClient[HttpClient]
+  end
+  DTO[DTO] --> Mappers[Мапперы]
+  Mappers --> Domain[Доменные типы]
+  Domain --> Service[API сервис]
+  Service --> HttpClient
+  Service --> Thunk[Thunk]
+  Thunk --> Store[Store]
+  Store --> UI[UI]
+```
+
+## Матрица: что меняю → какие правила перечитать
+
+| Зона в репозитории | Правила Cursor (`.cursor/rules/`) |
+|--------------------|-----------------------------------|
+| `app/src/api/clients/**`, `app/src/lib/clients/**` | `http-client.mdc`; при изменении клиента — `tests-unit.mdc` (behavior‑тесты) |
+| `app/src/api/services/**` | `api-services.mdc`; при необходимости `http-client.mdc` |
+| `app/src/store/**` | `store-rtk.mdc`, `architecture-boundaries.mdc` |
+| `app/src/ui/**` | `react-ui.mdc`, `no-props-spread.mdc`, `types-public-imports.mdc` |
+| `app/src/types/**` | `types-public-imports.mdc`, `types-jsdoc.mdc` |
+| `app/__tests__/e2e/**` | `tests-e2e-structure.mdc`, `playwright-agents.mdc` |
+
+Специализированные `.mdc` с `globs` подмешиваются при работе с соответствующими файлами; эта матрица нужна, когда открыт другой файл или идёт общий чат.
+
+## Требование к агенту
+
+При добавлении или существенном расширении фичи **пройти чеклист сверху** и при правках в зоне из таблицы **ориентироваться на указанные правила**, не смешивать слои и не обходить public API модулей.

package/presets/cursor/next/rules/next-app-core.mdc

@@ -78,6 +78,7 @@ alwaysApply: true
 # Работа агента
 
 При генерации кода:
+- При добавлении или существенном расширении фичи следовать **`feature-delivery-workflow.mdc`** (чеклист слоёв и матрица «зона → правило»).
 - Определить целевой слой (UI/store/API/типизация/тесты).
 - Найти в соответствующей директории похожие примеры и **копировать архитектурный паттерн** (структура файлов, типы, именование).
 - Не упрощать архитектуру в ущерб существующим слоям (не тянуть DTO и HTTP в UI; вызовы сервисов из UI — только в рамках `architecture-boundaries.mdc`).

package/presets/cursor/next/rules/tests-unit.mdc

@@ -1,11 +1,14 @@
 ---
 description: Unit и интеграционные тесты (Testing Library и runner проекта)
-globs: app/src/**/*.{spec,test}.{ts,tsx}
+globs:
+  - app/src/**/*.spec.{ts,tsx}
+  - app/src/**/*.test.{ts,tsx}
 alwaysApply: false
 ---
 
 # Общие правила тестирования
 
+- **Имена файлов:** для **новых** тестов использовать суффикс **`*.spec.ts` / `*.spec.tsx`**. Существующие **`*.test.ts` / `*.test.tsx`** не переименовывать без отдельной задачи (легаси).
 - **Runner и матчеры** — как в проекте (часто Jest или Vitest); для компонентов — **@testing-library/react**.
 - Основная цель тестов:
   - проверять **поведение и бизнес‑правила**, а не реализацию или внутренние детали.
@@ -39,7 +42,7 @@ it('Returns empty list when user is guest', () => {})
 
 # HTTP‑клиент
 
-- При изменении **реализации общего HTTP‑клиента** (разбор тел, заголовки, ветки ошибок, 401/refresh, `FormData`, `blob` и т.п.) — **обновить или добавить behavior‑тесты** рядом с модулем клиента в `app/src/lib/clients/**` (`*.spec.ts` / `*.test.ts` — как принято в репо).
+- При изменении **реализации общего HTTP‑клиента** (разбор тел, заголовки, ветки ошибок, 401/refresh, `FormData`, `blob` и т.п.) — **обновить или добавить behavior‑тесты** рядом с модулем клиента в `app/src/lib/clients/**` (предпочтительно `*.spec.ts`; легаси `*.test.ts` — не трогать без задачи).
 - Проверять смысловые ветки: успешный JSON, HTTP‑ошибка, сеть, релевантные для проекта сценарии авторизации.
 
 # Мапперы и преобразование данных
@@ -50,12 +53,13 @@ it('Returns empty list when user is guest', () => {})
 # Требование к агенту
 
 При добавлении тестов:
-- Следовать существующей структуре и паттернам тестов в `app/src/**/__tests__/**` или рядом с компонентом.
+- Следовать существующей структуре и паттернам тестов в репозитории: файл `*.spec.ts(x)` рядом с модулем или в общем каталоге тестов — как в соседних фичах.
 - Добавлять тесты для критичных веток логики и edge‑кейсов.
  - При работе с данными:
    - использовать **типы респонса** из API (DTO‑типы), а также **целевые доменные типы** из `@/types`, не дублировать интерфейсы в тестах;
    - по возможности опираться на данные и обработчики из `app/src/mocks/**` (или аналог в репо), а не плодить случайные тестовые данные "с нуля".
- - При написании unit‑тестов рядом с компонентом или модулем:
-   - **не создавать** поддиректорию `__tests__` внутри папки компонента;
-   - именовать файлы тестов с суффиксом `*.spec.ts` / `*.spec.tsx`, а не `*.test.ts` / `*.test.tsx`.
+ - Размещение:
+   - для **компонентов UI** — **не создавать** поддиректорию `__tests__` внутри папки компонента; тест — соседний `*.spec.tsx`.
+   - в **других модулях** (например `api/services`) допустима уже существующая схема с `__tests__` — не ломать ради единообразия с UI.
+   - **новые** файлы — `*.spec.ts` / `*.spec.tsx` (см. блок «Имена файлов» выше).