@michaelbel/cuckcoder-mcp 1.6.11 → 1.6.12

package/assets/rules/app-badging.md

@@ -0,0 +1,170 @@
+---
+description: >-
+  Регресс-гард доступности устройств: aapt2 dump badging в golden-файл app/badging, обязательный
+  check<Variant>Badging в CI, необязательное железо через android:required=false
+paths:
+  - "**/*.gradle.kts"
+  - "**/AndroidManifest.xml"
+---
+
+`aapt2 dump badging` по собранному APK показывает эффективный набор `uses-feature` /
+`uses-permission` / `uses-sdk` — то, из-за чего Google Play скрывает приложение на планшетах,
+Android TV, Wear OS, складных устройствах и авто. Обновление зависимости может молча добавить
+`android:required` hardware feature (камера, телефония, автофокус) и срезать доступность, а в
+диффе исходников этого не видно. Гард фиксирует бейдж в golden-файл и валит CI при расхождении.
+
+## Что заводится в проекте
+
+- Convention-плагин `build-logic/`, который на каждый application-вариант регистрирует три задачи:
+  - `generate<Variant>Badging` — `aapt2 dump badging` по универсальному APK варианта → генерируемый
+    файл в `build/`.
+  - `update<Variant>Badging` — копирует генерируемый файл в golden `app/badging/<variant>.txt`
+    (запускается локально, результат коммитится и проходит ревью).
+  - `check<Variant>Badging` — сравнивает генерируемый с golden; при расхождении фейлит с диффом.
+- Golden-файлы `app/badging/*.txt` — под контролем версий; изменение бейджа всегда осознанное и
+  видно в PR.
+
+## Правила
+
+- `check<Variant>Badging` (как минимум для release-варианта) — обязательный шаг CI на каждый PR.
+- Изменение `app/badging/*.txt` в PR без соответствующей причины (новая фича, осознанное
+  требование к железу) — стоп-фактор ревью.
+- Все `uses-feature` для необязательного железа объявляй с `android:required="false"`; жёсткое
+  требование железа — только когда приложение без него нефункционально.
+- Не добавляй `check*Badging` в `dependsOn` обычной сборки — это отдельный verification-шаг, чтобы
+  не замедлять локальный цикл.
+
+## Скелет convention-плагина
+
+```kotlin
+// build-logic/convention/src/main/kotlin/AndroidApplicationBadgingConventionPlugin.kt
+import com.android.build.api.artifact.SingleArtifact
+import com.android.build.api.variant.ApplicationAndroidComponentsExtension
+import org.gradle.api.DefaultTask
+import org.gradle.api.Plugin
+import org.gradle.api.Project
+import org.gradle.api.file.RegularFileProperty
+import org.gradle.api.provider.Property
+import org.gradle.api.tasks.CacheableTask
+import org.gradle.api.tasks.Copy
+import org.gradle.api.tasks.InputFile
+import org.gradle.api.tasks.OutputFile
+import org.gradle.api.tasks.PathSensitive
+import org.gradle.api.tasks.PathSensitivity
+import org.gradle.api.tasks.TaskAction
+import org.gradle.kotlin.dsl.register
+
+class AndroidApplicationBadgingConventionPlugin : Plugin<Project> {
+    override fun apply(target: Project) {
+        val components = target.extensions
+            .getByType(ApplicationAndroidComponentsExtension::class.java)
+
+        components.onVariants { variant ->
+            val capitalised = variant.name.replaceFirstChar { it.uppercaseChar() }
+            val golden = target.rootDir.resolve("app/badging/${variant.name}.txt")
+            val generated = target.layout.buildDirectory.file("badging/${variant.name}.txt")
+            val apk = variant.artifacts.get(SingleArtifact.APK)
+
+            val generate = target.tasks.register<GenerateBadgingTask>("generate${capitalised}Badging") {
+                apkDir.set(apk)
+                aapt2.set(resolveAapt2(target))
+                output.set(generated)
+            }
+
+            target.tasks.register<Copy>("update${capitalised}Badging") {
+                group = "badging"
+                description = "Обновляет app/badging/${variant.name}.txt — закоммить результат"
+                dependsOn(generate)
+                from(generated)
+                into(golden.parentFile.also { it.mkdirs() })
+                rename { golden.name }
+            }
+
+            target.tasks.register<CheckBadgingTask>("check${capitalised}Badging") {
+                group = "verification"
+                description = "Фейлит, если требуемые фичи ${variant.name}-APK разошлись с golden-файлом"
+                dependsOn(generate)
+                generated.set(generated)
+                this.golden.set(golden)
+            }
+        }
+    }
+}
+
+@CacheableTask
+abstract class GenerateBadgingTask : DefaultTask() {
+    @get:InputFile @get:PathSensitive(PathSensitivity.NONE)
+    abstract val apkDir: RegularFileProperty
+
+    @get:org.gradle.api.tasks.Input
+    abstract val aapt2: Property<String>
+
+    @get:OutputFile
+    abstract val output: RegularFileProperty
+
+    @TaskAction
+    fun run() {
+        val apk = apkDir.get().asFile.parentFile
+            .listFiles { f -> f.extension == "apk" }?.firstOrNull()
+            ?: error("APK не найден в ${apkDir.get().asFile.parentFile}")
+        val out = output.get().asFile.also { it.parentFile.mkdirs() }
+        project.exec {
+            commandLine(aapt2.get(), "dump", "badging", apk.absolutePath)
+            standardOutput = out.outputStream()
+        }
+    }
+}
+
+@CacheableTask
+abstract class CheckBadgingTask : DefaultTask() {
+    @get:InputFile @get:PathSensitive(PathSensitivity.RELATIVE)
+    abstract val generated: RegularFileProperty
+
+    @get:InputFile @get:PathSensitive(PathSensitivity.RELATIVE)
+    abstract val golden: RegularFileProperty
+
+    @TaskAction
+    fun run() {
+        val g = generated.get().asFile.readText()
+        val expected = golden.get().asFile.let {
+            if (!it.exists()) error("Нет golden-файла ${it.path} — запусти update…Badging и закоммить")
+            it.readText()
+        }
+        if (g.trim() != expected.trim()) {
+            error(
+                "Бейдж APK разошёлся с golden-файлом ${golden.get().asFile.path}.\n" +
+                    "Если изменение осознанное — запусти ./gradlew update…Badging и закоммить новый golden."
+            )
+        }
+    }
+}
+
+private fun resolveAapt2(project: Project): String {
+    val android = project.extensions
+        .getByType(com.android.build.gradle.BaseExtension::class.java)
+    return android.sdkDirectory
+        .resolve("build-tools/${android.buildToolsVersion}/aapt2")
+        .absolutePath
+}
+```
+
+## CI
+
+```yaml
+# .github/workflows/pr-check.yml (фрагмент)
+      - name: App badging check
+        run: ./gradlew checkReleaseBadging
+```
+
+## Как выглядит golden-файл
+
+```
+# app/badging/release.txt
+package: name='com.example.app' versionCode='142' versionName='1.4.2'
+sdkVersion:'26'
+targetSdkVersion:'35'
+uses-permission: name='android.permission.INTERNET'
+uses-feature-not-required: name='android.hardware.camera'
+feature-group: label=''
+  uses-feature: name='android.hardware.faketouch'
+```

package/assets/rules/architecture.md

@@ -1,13 +1,13 @@
 ---
+description: >-
+  Размещение маппинга в KTX-файлах, один файл на модель, числовые сравнения Build.VERSION.SDK_INT
+  вместо буквенных констант
 paths:
   - "**/*.gradle.kts"
-  - "**/*.gradle"
   - "**/AndroidManifest.xml"
   - "**/*.kt"
 ---
 
-# Правила архитектуры
-
 - Помещай логику маппинга в KTX-файлы мапперов.
 - Для каждой модели создавай отдельный файл; не объявляй несколько классов моделей в одном файле.
 - Для проверок уровня Android API сравнивай `Build.VERSION.SDK_INT` с числовыми уровнями API; не

package/assets/rules/{bottom-sheet.md → compose-bottom-sheet.md}

@@ -1,13 +1,13 @@
 ---
+description: >-
+  Bottom sheet фичи с постфиксом _sheet, rememberModalBottomSheetState(skipPartiallyExpanded =
+  true), sheetState.hide() перед intent, preview в Box с fillMaxSize
 paths:
   - "**/*.gradle.kts"
-  - "**/*.gradle"
   - "**/AndroidManifest.xml"
   - "**/*.kt"
 ---
 
-# Правила Bottom Sheet
-
 - Пакеты bottom sheet фич в `features` используют постфикс `_sheet`, например
   `features/profile_sheet`.
 - Используй file-level `@file:OptIn(ExperimentalMaterial3Api::class)`, когда файл использует

package/assets/rules/compose-color.md

@@ -1,13 +1,13 @@
 ---
+description: >-
+  Цвета только через MaterialTheme.colorScheme, новые цвета в Colors UI kit по HTML-имени hex, цвета
+  TopAppBar через TopAppBarDefaults
 paths:
   - "**/*.gradle.kts"
-  - "**/*.gradle"
   - "**/AndroidManifest.xml"
   - "**/*.kt"
 ---
 
-# Правила цвета Compose
-
 - Используй цвета через `MaterialTheme.colorScheme`; не используй сырые константы `Color` для
   тематических цветов внутри компонентов.
 - Добавляй новые UI-цвета в файл Colors UI kit и предоставляй их через `MaterialTheme.colorScheme`;

package/assets/rules/compose-constraintlayout.md

@@ -1,13 +1,13 @@
 ---
+description: >-
+  Порядок ограничений в constrainAs (width, height, start, top, end, bottom) и размеры через API
+  Dimension вместо внешних modifier
 paths:
   - "**/*.gradle.kts"
-  - "**/*.gradle"
   - "**/AndroidManifest.xml"
   - "**/*.kt"
 ---
 
-# Правила ConstraintLayout
-
 - В блоке `constrainAs` упорядочивай присваивания ограничений так: `width`, `height`, `start`,
   `top`, `end`, `bottom`.
 - Когда composable позиционируется через `constrainAs`, объявляй его размер внутри блока

package/assets/rules/{dialog.md → compose-dialog.md}

@@ -1,13 +1,13 @@
 ---
+description: >-
+  Выбор AlertDialog vs BasicAlertDialog по наличию кнопок действий, слоты icon/title/text,
+  оформление кнопок подтверждения и отмены
 paths:
   - "**/*.gradle.kts"
-  - "**/*.gradle"
   - "**/AndroidManifest.xml"
   - "**/*.kt"
 ---
 
-# Правила Dialog
-
 - Используй `AlertDialog`, когда в диалоге есть кнопки действий; используй `BasicAlertDialog`, когда
   кнопок действий нет.
 - Для `AlertDialog` передавай слот `icon`, когда нужна иконка; устанавливай

package/assets/rules/{lazylist.md → compose-lazy.md}

@@ -1,13 +1,11 @@
 ---
+description: >-
+  contentPadding из Scaffold через оператор +, Arrangement.spacedBy вместо Spacer между элементами,
+  завершающий Spacer только в конце списка
 paths:
-  - "**/*.gradle.kts"
-  - "**/*.gradle"
-  - "**/AndroidManifest.xml"
   - "**/*.kt"
 ---
 
-# Правила LazyList
-
 - Передавай `innerPadding` из `Scaffold` в `contentPadding`, а не как `Modifier.padding`; комбинируй
   с дополнительными отступами через оператор `+`:
   `contentPadding = innerPadding + PaddingValues(bottom = 72.dp)`.

package/assets/rules/{shimmer.md → compose-loading.md}

@@ -1,13 +1,11 @@
 ---
+description: >-
+  Skeleton-загрузка через Modifier.placeholder с PlaceholderHighlight.shimmer, Spacer vs Box для
+  placeholder, visible привязан к state.isLoading
 paths:
-  - "**/*.gradle.kts"
-  - "**/*.gradle"
-  - "**/AndroidManifest.xml"
   - "**/*.kt"
 ---
 
-# Правила Shimmer / Loading Placeholder
-
 - Используй
   `Modifier.placeholder(visible = ..., highlight = PlaceholderHighlight.shimmer(), color = MaterialTheme.colorScheme.surfaceContainerHigh, shape = RoundedCornerShape(...))`
   для skeleton-загрузки.

package/assets/rules/{preview.md → compose-preview.md}

@@ -1,13 +1,11 @@
 ---
+description: >-
+  Preview через @PreviewWrapper(ThemeWrapper::class), вызов приватного *Content, одна функция
+  preview с PreviewParameterProvider на все значимые состояния
 paths:
-  - "**/*.gradle.kts"
-  - "**/*.gradle"
-  - "**/AndroidManifest.xml"
   - "**/*.kt"
 ---
 
-# Правила Preview
-
 - Всегда аннотируй previews через `@PreviewWrapper(ThemeWrapper::class)`.
 - Preview должны вызывать приватный composable `*Content`, а не публичный composable `*Screen`,
   принимающий ViewModel.
@@ -25,6 +23,9 @@ paths:
   состояние по умолчанию/первое.
 - Используй `BooleanProvider` для preview с булевыми параметрами.
 - Классы `PreviewParameterProvider` приватные и объявляются в конце файла.
+- Вспомогательные значения, которые использует только `PreviewParameterProvider` (списки сущностей,
+  отдельные экземпляры), объявляй приватными свойствами внутри самого класса провайдера перед
+  `values`, а не на уровне файла.
 - Строй значения preview и `PreviewParameterProvider` через `Empty.copy(...)`, когда модель
   предоставляет экземпляр `Empty`; не создавай их полным явным вызовом конструктора.
 - В вызовах `Empty.copy(...)` для preview устанавливай только те поля, которые компонент

package/assets/rules/{scaffold.md → compose-scaffold.md}

@@ -1,13 +1,11 @@
 ---
+description: >-
+  Размещение обычного и ошибочного snackbar внутри и вне Scaffold, SnackbarMessage vs
+  SnackbarErrorMessage, раздельные SnackbarHostState
 paths:
-  - "**/*.gradle.kts"
-  - "**/*.gradle"
-  - "**/AndroidManifest.xml"
   - "**/*.kt"
 ---
 
-# Правила Scaffold
-
 - Snackbar для обычных сообщений размещай внутри `snackbarHost` в `Scaffold`; snackbar, которые
   должны появляться над статус-баром (верхние баннеры ошибок), размещай вне `Scaffold` в
   оборачивающем `Box`, выровненном по `Alignment.TopCenter`, с `Modifier.statusBarsPadding()`.

package/assets/rules/compose-screen.md

@@ -1,13 +1,13 @@
 ---
+description: >-
+  Разделение публичного {Feature}Screen и приватного {Feature}ScreenContent, сбор state и событий в
+  публичном, отсутствие бизнес-логики в Content
 paths:
   - "**/*.gradle.kts"
-  - "**/*.gradle"
   - "**/AndroidManifest.xml"
   - "**/*.kt"
 ---
 
-# Правила Compose-экранов
-
 - Публичный `{Feature}Screen(viewModel = hiltViewModel())` собирает state, создаёт
   remembered-хелперы событий, наблюдает события и делегирует UI приватному `{Feature}ScreenContent`.
 - `*ScreenContent` получает `state`, `dispatch` и любые remembered UI-хелперы, нужные для preview.

package/assets/rules/compose-spacing.md

@@ -1,13 +1,13 @@
 ---
+description: >-
+  Порядок именованных параметров padding и PaddingValues по сигнатуре метода, пропуск аргументов
+  равных 0.dp
 paths:
   - "**/*.gradle.kts"
-  - "**/*.gradle"
   - "**/AndroidManifest.xml"
   - "**/*.kt"
 ---
 
-# Правила отступов и размеров Compose
-
 - Для `padding(...)` и `PaddingValues(...)` упорядочивай именованные параметры согласно сигнатуре
   метода: `start`, `top`, `end`, `bottom`; либо при использовании сокращённой формы — `horizontal`,
   `vertical`.

package/assets/rules/{textfield.md → compose-textfield.md}

@@ -1,13 +1,9 @@
 ---
+description: Поля поиска хранят TextFieldValue с явно заданным selection в конце текста, а не String
 paths:
-  - "**/*.gradle.kts"
-  - "**/*.gradle"
-  - "**/AndroidManifest.xml"
   - "**/*.kt"
 ---
 
-# Правила TextField
-
 - Для `TextField`, являющихся полями поиска, храни значение как `TextFieldValue`, а не как `String`,
   и всегда явно устанавливай `selection`, чтобы курсор находился в конце текста, а не в начале:
   ```kotlin

package/assets/rules/{typography.md → compose-typography.md}

@@ -1,13 +1,11 @@
 ---
+description: >-
+  Стиль текста только через аргумент style, база MaterialTheme.typography с .copy, визуальные поля
+  внутри style а не отдельными аргументами Text
 paths:
-  - "**/*.gradle.kts"
-  - "**/*.gradle"
-  - "**/AndroidManifest.xml"
   - "**/*.kt"
 ---
 
-# Правила типографики
-
 - Всегда устанавливай стиль текста через аргумент `style` в `Text` или `SharedFixedText`; никогда
   не используй отдельные аргументы `fontSize`, `fontWeight` или `color`.
 - Используй расширения `MaterialTheme.typography.<token>` как базовый стиль, затем применяй

package/assets/rules/compose.md

@@ -1,13 +1,13 @@
 ---
+description: >-
+  Обязательный preview для каждого composable, modifier первым опциональным параметром,
+  {Component}State при более чем одном поле данных или callback
 paths:
   - "**/*.gradle.kts"
-  - "**/*.gradle"
   - "**/AndroidManifest.xml"
   - "**/*.kt"
 ---
 
-# Правила Compose
-
 - При создании composable-функции всегда создавай для неё preview.
 - Параметр `modifier` должен быть первым опциональным параметром в сигнатуре composable-функции.
 - Когда composable-компоненту нужно больше одного поля данных или callback, перенеси эти поля в
@@ -17,6 +17,10 @@ paths:
   вместо этого предоставляй его как вычисляемое свойство с явным типом и геттером на самом
   `{Component}State` data class, и читай это свойство напрямую в composable вместо пересчёта условия
   inline.
+- Не используй `nullableField?.let { ... }` как условие отображения дочернего composable. Заведи на
+  `{Component}State` вычисляемое булево свойство (`val isXxxVisible: Boolean get() = field != null`) и
+  оборачивай разметку в `if (state.isXxxVisible) { ... }`, а внутри ветки читай nullable-поле
+  напрямую, при необходимости через `requireNotNull(state.field)`.
 - Composable-экраны и компоненты не должны содержать бизнес-логику, ветвящиеся функции принятия
   решений или `if`/`else`, определяющие domain-поведение; переноси эту логику в ViewModel и рендери
   уже подготовленное UI-состояние.
@@ -28,6 +32,12 @@ paths:
   другими правилами, например `*ScreenContent`.
 - Используй обёртку компонента `Shared*` проекта вместо прямого компонента фреймворка, когда такая
   обёртка существует в проекте.
+- Не используй `Surface` в простых компонентах вроде карточек, плашек и контейнеров с фоном и
+  скруглением. Задавай форму и фон напрямую на `Modifier` контейнера (`Box`, `Column`, `Row`) через
+  `clip(RoundedCornerShape(...))` и `background(...)`, а внутренние отступы — через `padding(...)`.
+  `Surface` допустим только там, где реально нужны его возможности: интерактивные поверхности с
+  `onClick`, `selected` или `enabled`, tonal/shadow elevation, camera preview и подобные
+  нетривиальные случаи.
 - В composable используй `val resources = LocalResources.current`; не используй
   `val resources = LocalContext.current.resources`.
 - Вызовы composable с именованными аргументами всегда форматируй многострочно: имя composable,

package/assets/rules/domain.md

@@ -1,13 +1,13 @@
 ---
+description: >-
+  Domain-операции в классах UseCase и FlowUseCase в shared/domain/usecase, инъекция
+  Room/Ktor/DataStore в конструктор, обработка ответов через handleResponse
 paths:
   - "**/*.gradle.kts"
-  - "**/*.gradle"
   - "**/AndroidManifest.xml"
   - "**/*.kt"
 ---
 
-# Правила Domain
-
 - Операции domain-слоя находятся в конкретных классах `UseCase` и `FlowUseCase` в
   `shared/domain/usecase`.
 - Зависимости Room, Ktor, DataStore и бизнес-логики внедряются напрямую в конструктор use case.

package/assets/rules/filesystem.md

@@ -1,3 +1,5 @@
-# Правила проекта
+---
+description: При удалении файлов удалять и все директории, которые в результате становятся пустыми
+---
 
 - При удалении файлов также удаляй все директории, которые в результате становятся пустыми.

package/assets/rules/git.md

@@ -1,4 +1,8 @@
-# Правила Git
+---
+description: >-
+  Целевые коммиты по одному логическому изменению, коммит всех изменений по запросу пользователя,
+  обновления зависимостей форматом Bump <dep> from <old> to <new>
+---
 
 - Никогда не коммить несвязанные файлы вместе; добавляй файлы в индекс выборочно и делайте один
   целевой коммит на каждое логическое изменение с понятным, конкретным сообщением.

package/assets/rules/github-readme.md

@@ -1,4 +1,8 @@
-# Правила GitHub README
+---
+description: >-
+  Фиксированная структура README: бейдж last-commit, описание в два предложения, скриншот, раздел
+  Technologies с shields.io for-the-badge бейджами
+---
 
 Каждый README следует этой фиксированной структуре в этом порядке:
 

package/assets/rules/github-repo.md

@@ -1,4 +1,8 @@
-# Правила структуры репозитория
+---
+description: >-
+  Обязательная структура GitHub-репозитория: FUNDING.yml, CODEOWNERS, .idea/icon.svg, whitelist
+  .gitignore, AGENTS.md с симлинками CLAUDE.md и GEMINI.md
+---
 
 Каждый GitHub-репозиторий должен следовать этой структуре.
 

package/assets/rules/{navigation.md → jetpack-navigation.md}

@@ -1,13 +1,11 @@
 ---
+description: >-
+  Маршруты как @Serializable data class или data object реализующие NavKey в
+  features/{feature}/navigation, аргументы через savedStateHandle.toRoute
 paths:
-  - "**/*.gradle.kts"
-  - "**/*.gradle"
-  - "**/AndroidManifest.xml"
   - "**/*.kt"
 ---
 
-# Правила навигации
-
 - Каждый маршрут экрана — это `@Serializable data class` или `@Serializable data object`,
   реализующий `NavKey`.
 - Маршруты находятся в `features/{feature}/navigation`.

package/assets/rules/{room.md → jetpack-room.md}

@@ -1,15 +1,17 @@
 ---
+description: >-
+  Порядок методов DAO (fun перед suspend fun), рост DATABASE_VERSION, алфавитный порядок entity и
+  DAO, primaryKeys в @Entity, withTransaction на уровне use case
 paths:
-  - "**/*.gradle.kts"
-  - "**/*.gradle"
-  - "**/AndroidManifest.xml"
   - "**/*.kt"
 ---
 
-# Правила Room
-
 - В интерфейсах DAO размещай все обычные методы `fun` перед любыми методами `suspend fun`.
 - При изменении таблиц или entity базы данных Room всегда увеличивай `AppDatabase.DATABASE_VERSION`.
+- Держи Room-объекты в алфавитном порядке (A–Z) в списке `entities` аннотации `@Database`, в
+  объявлениях `abstract fun ...Dao()` внутри `AppDatabase` и в `@Provides`-методах, поставляющих DAO
+  в DI-модуле. При добавлении, изменении или удалении entity либо DAO проверяй и восстанавливай этот
+  порядок во всех трёх местах.
 - Для entity Room объявляй первичные ключи в параметре `@Entity(primaryKeys = [...])` вместо
   использования `@PrimaryKey` на свойстве.
 - В интерфейсах `@Dao` помечай методы, возвращающие типы Pojo, аннотацией `@Transaction`, чтобы

package/assets/rules/{workmanager.md → jetpack-work.md}

@@ -1,13 +1,11 @@
 ---
+description: >-
+  Тонкий CoroutineWorker вызывающий бизнес-UseCase через getOrThrow, планирование и отмена в
+  отдельных UseCase, constraints, unique work и retry policy
 paths:
-  - "**/*.gradle.kts"
-  - "**/*.gradle"
-  - "**/AndroidManifest.xml"
   - "**/*.kt"
 ---
 
-# Правила WorkManager
-
 - Реализуй фоновую задачу как тонкий `CoroutineWorker`: worker читает и проверяет входные данные,
   вызывает существующий бизнес-`UseCase` через `.getOrThrow()` и преобразует итог в
   `Result.success()`, `Result.retry()` или `Result.failure()`. Для чисто Android-системной операции,

package/assets/rules/kmp.md

@@ -1,13 +1,13 @@
 ---
+description: >-
+  Синхронное обновление версии приложения во всех таргетах: androidApp, desktopApp, iosAppCompose и
+  iosApp Version.xcconfig
 paths:
   - "**/*.gradle.kts"
-  - "**/*.gradle"
   - "**/AndroidManifest.xml"
   - "**/*.kt"
 ---
 
-# Правила KMP
-
 - При обновлении версии приложения обновляй её во всех таргетах: `androidApp/build.gradle.kts`
   (`versionName`), `desktopApp/build.gradle.kts` (`desktopVersionName`),
   `iosAppCompose/build.gradle.kts` (`iosVersionName`) и `iosApp/Configuration/Version.xcconfig`

package/assets/rules/kotlin-coroutines.md

@@ -0,0 +1,15 @@
+---
+description: >-
+  Запрет GlobalScope, инъекция CoroutineDispatcher в конструктор вместо хардкода, обёртка тела ветки
+  when в фигурные скобки перед launch
+paths:
+  - "**/*.gradle.kts"
+  - "**/*.kt"
+---
+
+- Не используй `GlobalScope`; запускай корутины только в scope с определённым жизненным циклом
+  (переданный `CoroutineScope`, scope MVI-стора).
+- Не хардкодь `Dispatchers.IO`/`Dispatchers.Default`/`Dispatchers.Main` внутри классов; принимай
+  `CoroutineDispatcher` параметром конструктора, чтобы тест подставлял `TestDispatcher`.
+- В ветках `when` не ставь `launch` сразу после `->`; оборачивай тело ветки в фигурные скобки и
+  вызывай `launch { ... }` внутри блока ветки, даже если `launch` — единственная инструкция.

package/assets/rules/kotlin.md

@@ -1,18 +1,19 @@
 ---
+description: >-
+  Длина строки до 150 символов, when вместо цепочек if/else if, return when, fail-fast ранним
+  return/throw вместо вложенных if/else, однострочные ветки when только при полном размещении
 paths:
   - "**/*.gradle.kts"
-  - "**/*.gradle"
-  - "**/AndroidManifest.xml"
   - "**/*.kt"
 ---
 
-# Правила Kotlin
-
 - Допускай длину строки Kotlin-кода до 150 символов; не переноси код только ради стандартного
   ограничения IDE в 100 символов.
 - Предпочитай `when` вместо цепочек `if / else if` при выражении ветвящейся логики.
 - При возврате одной из двух веток предпочитай `return when { ... }` вместо
   `return if (...) ... else ...`.
+- Применяй принцип fail-fast: отсеивай невалидные и граничные случаи ранним `return`, `throw` или
+  `require` / `check` в начале функции, а не оборачивай основную логику во вложенные `if / else`.
 - В ветках `when` используй однострочную форму без фигурных скобок только если вся ветка помещается
   на одной строке: `condition -> statement`; если тело ветки многострочное, оборачивай его в
   фигурные скобки, даже если оно содержит только одну инструкцию.

package/assets/rules/mvi-error-handling.md

@@ -1,13 +1,11 @@
 ---
+description: >-
+  Импорт вложенных исключений use case во ViewModel, порядок catch от специфичных сетевых к общим,
+  сброс Job запроса и SnackbarErrorMessage
 paths:
-  - "**/*.gradle.kts"
-  - "**/*.gradle"
-  - "**/AndroidManifest.xml"
   - "**/*.kt"
 ---
 
-# Правила обработки ошибок в MVI
-
 - Импортируй вложенные исключения use case напрямую в ViewModel, например
   `import shared.domain.usecase.ItemsDetailsUseCase.ItemsDetailsException`.
 - В `catch` ViewModel обрабатывай специфичное сетевое исключение фичи раньше более общих исключений:

package/assets/rules/mvi-state.md

@@ -1,13 +1,11 @@
 ---
+description: >-
+  Room Entity напрямую в Model и composable без промежуточных UI-моделей, имена ...Entity и
+  ...Entities, производные свойства с кастомным геттером
 paths:
-  - "**/*.gradle.kts"
-  - "**/*.gradle"
-  - "**/AndroidManifest.xml"
   - "**/*.kt"
 ---
 
-# Правила Model в MVI
-
 - Для данных, поддерживаемых Room, храни и передавай класс `Entity` из Room напрямую в классах
   `Model` фичи и composable-компонентах; не маппи его в UI-модель или другой промежуточный класс.
 - В классах `Model` фичи называй свойства Room entity по форме entity: используй `...Entity` для

package/assets/rules/mvi.md

@@ -1,13 +1,11 @@
 ---
+description: >-
+  Раскладка features/{feature} на Screen/ViewModel/Model/Intent/Event/Route, @HiltViewModel с
+  конструкторной инъекцией, обязательные MVI-классы для каждого экрана
 paths:
-  - "**/*.gradle.kts"
-  - "**/*.gradle"
-  - "**/AndroidManifest.xml"
   - "**/*.kt"
 ---
 
-# Правила MVI
-
 - Экраны фич находятся в `features/{feature}` и разбиты на `{Feature}Screen.kt`,
   `{Feature}ViewModel.kt`, `model/{Feature}Model.kt`, `intent/{Feature}Intent.kt`, опционально
   `event/{Feature}Event.kt` и опционально `navigation/{Feature}Route.kt`.
@@ -31,6 +29,8 @@ paths:
   ветку `dispatch` либо выноси их из ViewModel в соответствующий архитектурный слой.
 - `dispatch` — это `when` по всем веткам intent без `else`; состояние меняется только через
   `reduce { it.copy(...) }`.
+- Не именуй параметр лямбды `reduce`: пиши `reduce { it.copy(...) }`, а не
+  `reduce { state -> state.copy(...) }`.
 - Одноразовые действия используют `send({Feature}Event...)` из ViewModel и `ObserveAsEvents` на
   экране.
 - Типы `Intent`, `Model` и `Event` реализуют общие маркерные интерфейсы MVI проекта.

package/assets/rules/network.md

@@ -1,13 +1,11 @@
 ---
+description: >-
+  Имена моделей на Request и Response, @Serializable и @SerialName на каждом поле, имена сетевых use
+  case по пути запроса в PascalCase плюс UseCase
 paths:
-  - "**/*.gradle.kts"
-  - "**/*.gradle"
-  - "**/AndroidManifest.xml"
   - "**/*.kt"
 ---
 
-# Правила сети
-
 - Имена классов моделей запросов должны заканчиваться на `Request`.
 - Имена классов моделей ответов должны заканчиваться на `Response`.
 - Каждая модель запроса и ответа должна быть аннотирована `@Serializable`, а каждое поле должно

package/assets/rules/realtime.md

@@ -1,13 +1,11 @@
 ---
+description: >-
+  Отдельный RealtimeDataSource на каждый hub или канал, общая инфраструктура соединения, регистрация
+  обработчиков до подключения, conflatable invalidation через SharedFlow
 paths:
-  - "**/*.gradle.kts"
-  - "**/*.gradle"
-  - "**/AndroidManifest.xml"
   - "**/*.kt"
 ---
 
-# Правила realtime-соединений
-
 - Создавай отдельный `RealtimeDataSource` для каждого hub/канала предметной области. Общие
   создание соединения, аутентификацию, retry/backoff, логирование и закрытие держи в общей
   инфраструктуре соединения.

package/assets/rules/resource.md

@@ -1,13 +1,12 @@
 ---
+description: >-
+  UI-строки только через фасад строк проекта без прямого R.string/R.plurals и хардкода в Kotlin или
+  XML, новые строки в strings.xml
 paths:
-  - "**/*.gradle.kts"
-  - "**/*.gradle"
-  - "**/AndroidManifest.xml"
+  - "**/*.xml"
   - "**/*.kt"
 ---
 
-# Правила ресурсов
-
 - Строки UI используются через фасад строк проекта, а не через прямое использование `R.string` или
   `R.plurals` в UI-коде.
 - Не хардкодь пользовательские строки напрямую в Kotlin или XML UI-коде; добавляй их в `strings.xml`

package/assets/rules/security.md

@@ -0,0 +1,112 @@
+---
+description: >-
+  Базовые требования безопасности из OWASP MASVS и Mobile Top 10 (2024): секреты, хранение, сеть,
+  криптография, IPC, логирование
+paths:
+  - "**/*.kt"
+---
+
+Базовые требования по безопасности для Kotlin/Android/KMP-кода, сжатые из OWASP MASVS и Mobile
+Top 10 (2024). Это стандарты, которые соблюдаются при написании кода; полный доказательный
+аудит с threat model и эксплуатационными сценариями делает агент `security-auditor`, массовый
+проход по модулям — workflow `security-sweep`.
+
+## Секреты и конфигурация сборки
+
+- Не коммить ключи, токены, пароли, keystore и `google-services.json` с реальными ключами; храни
+  их в `local.properties` (в `.gitignore`), в переменных окружения CI или в секрет-хранилище.
+- Не клади секреты в `BuildConfig` и в ресурсы: значения из `BuildConfig` тривиально достаются из
+  APK. Для клиентских идентификаторов, которые всё равно попадают в бинарь, полагайся на
+  серверную проверку, а не на «скрытость».
+- `.gitignore` должен содержать `local.properties`, `*.jks`, `*.keystore`, `*.p12`, `*.pem`,
+  `secrets*.properties`.
+- В KMP секреты не размещай в `commonMain`; платформенные ключи подаются через `expect/actual`
+  провайдер, который на каждой платформе читает из защищённого хранилища.
+
+## Транспорт
+
+- Только HTTPS. В `AndroidManifest.xml` держи `android:usesCleartextTraffic="false"`; исключения
+  оформляй через `network_security_config.xml` с явным списком доменов и только для отладки.
+- Certificate pinning для собственного backend:
+  - OkHttp — `CertificatePinner` с pin-set из SPKI SHA-256 leaf/intermediate сертификата.
+  - Ktor (Darwin/OkHttp engine) — pinning на уровне engine-конфига соответствующей платформы.
+  - Всегда закладывай минимум два пина (текущий + запасной) и документируй дату ротации; пин без
+    запасного превращает продление сертификата в отказ обслуживания.
+- Не отключай проверку хоста и не подставляй `TrustManager`, принимающий все сертификаты, даже
+  во flavor'ах для тестирования, которые могут случайно уехать в релиз.
+
+## Хранение данных
+
+- Чувствительные данные (токены сессии, PII) — только в шифрованном хранилище:
+  `EncryptedSharedPreferences` / шифрованный `DataStore` с ключом из `MasterKey`
+  (`AES256_GCM`), либо Android Keystore напрямую.
+- Не пиши чувствительные данные в обычный `SharedPreferences`, в файлы на внешнем хранилище, в
+  имена файлов кэша и в логи.
+- Room-база с чувствительными данными — SQLCipher или хранение только зашифрованных значений;
+  ключ БД не хардкодь.
+- `android:allowBackup` — выключай (`false`) либо задавай `fullBackupContent` / `dataExtractionRules`,
+  исключающие секретные файлы, иначе токены утекут в облачный бэкап.
+
+## Манифест и экспорт компонентов
+
+- Каждому `activity`/`service`/`receiver`/`provider` явно проставляй `android:exported`;
+  `exported="true"` без строгой проверки вызывающего — потенциальный вектор.
+- Экспортированные компоненты, принимающие `Intent`, валидируют все extras и `data`-URI;
+  `ContentProvider` с `grantUriPermissions` — только на конкретные пути; deep links не дают
+  доступ к привилегированным экранам без проверки авторизации.
+- Детальный разбор Intent-поверхности (redirection, implicit intents, `PendingIntent`
+  mutability) — скилл `android-intent-security` из маркетплейса `android-skills`.
+
+## Логирование и релизный билд
+
+- В релизе не логируй PII, токены, тела запросов/ответов. ProGuard/R8-правило вырезает `Log.*` и
+  `println` из релиза:
+
+  ```proguard
+  -assumenosideeffects class android.util.Log {
+      public static int v(...);
+      public static int d(...);
+      public static int i(...);
+      public static int w(...);
+      public static int e(...);
+  }
+  ```
+
+- Релизный билд: `isMinifyEnabled = true`, `isShrinkResources = true`, R8 full mode
+  (`android.enableR8.fullMode=true`). Проверяй, что `mapping.txt` сгенерирован и загружен в
+  Play Console / crash-репортер.
+- `isDebuggable` в релизе — только `false`. `BuildConfig.DEBUG`-ветки не должны открывать
+  тестовые бэкдоры в релизной конфигурации.
+
+## Аутентификация и криптография
+
+- Не изобретай криптографию: `javax.crypto` / Tink / платформенные API. AES только в режиме с
+  аутентификацией (`GCM`), IV — случайный на каждое сообщение, не переиспользуется.
+- Биометрия — `BiometricPrompt` с `CryptoObject`, привязанным к ключу Keystore
+  (`setUserAuthenticationRequired(true)`); «биометрия ради галочки» без `CryptoObject` не
+  защищает данные.
+- Play Integrity API для проверки целостности клиента там, где это оправдано: nonce генерируется
+  на сервере, ответ верифицируется на сервере, вердикт не кэшируется на клиенте.
+- Токены сессии — короткоживущие, обновляются по refresh-токену; логаут инвалидирует токены и на
+  сервере, и в локальном хранилище.
+
+## Supply chain
+
+- Версии зависимостей — только через version catalog; не тяни динамические версии (`+`,
+  `latest.release`).
+- Включай dependency verification (`gradle/verification-metadata.xml`) или как минимум
+  dependency review в CI.
+- Плагины Gradle и GitHub Actions пинуй: экшены — по полному commit SHA, не по mutable-тегу.
+
+## Чек-лист перед релизом
+
+- [ ] в диффе и в истории нет секретов (`git log -p`, secret-scanner)
+- [ ] `usesCleartextTraffic=false`, network security config без общих исключений
+- [ ] certificate pinning для собственного backend, есть запасной пин
+- [ ] чувствительные данные только в шифрованном хранилище
+- [ ] `allowBackup=false` или бэкап-правила исключают секреты
+- [ ] у всех компонентов явный `exported`, экспортированные валидируют вход
+- [ ] R8 full mode, `Log.*` вырезан, `mapping.txt` сохранён
+- [ ] `isDebuggable=false`, нет debug-бэкдоров
+- [ ] биометрия через `CryptoObject`, крипто — только аутентифицированные режимы
+- [ ] версии зависимостей зафиксированы, экшены пиннятся по SHA

package/assets/rules/usecase.md

@@ -1,13 +1,11 @@
 ---
+description: >-
+  Операции Room/Ktor/DataStore и бизнес-логика в классах UseCase и FlowUseCase в
+  shared/domain/usecase без слоёв Repository или Interactor, конструкторная инъекция
 paths:
-  - "**/*.gradle.kts"
-  - "**/*.gradle"
-  - "**/AndroidManifest.xml"
   - "**/*.kt"
 ---
 
-# Правила UseCase
-
 - Размещай операции Room, Ktor, DataStore и бизнес-операции в конкретных классах `UseCase` /
   `FlowUseCase` в `shared/domain/usecase`; не создавай слои Repository или Interactor для новой
   работы.

package/assets/rules/workflow.md

@@ -1,4 +1,8 @@
-# Правила рабочего процесса
+---
+description: >-
+  Соглашения проекта, дублирование вместо преждевременных абстракций, делегирование реализации
+  профильным саб-агентам, крупные задачи через фоновый агент в worktree
+---
 
 - Используй стандартные соглашения проекта и следуй существующей документации при внесении
   изменений.

package/assets/skills/create-feature-bottom-sheet/SKILL.md

@@ -31,18 +31,23 @@ lower camel case, а `{package}` на целевой пакет.
 
 Файлы:
 - `features/{feature}_sheet/{Feature}BottomSheet.kt`
-- `features/{feature}_sheet/intent/{Feature}SheetIntent.kt`
-- optional `features/{feature}_sheet/model/{Feature}SheetModel.kt`
+- `features/{feature}_sheet/intent/{Feature}Intent.kt`
+- optional `features/{feature}_sheet/model/{Feature}Model.kt`
 
-### {Feature}SheetIntent.kt
+MVI-типы sheet называются `{Feature}Intent` и `{Feature}Model` — без инфикса `Sheet`. Инфикс
+`Sheet` остаётся только в имени пакета (`{feature}_sheet`), в composable (`{Feature}BottomSheet`) и
+в идентификаторах на стороне вызывающего экрана (`is{Feature}SheetVisible`, `On{Feature}SheetIntent`,
+`{feature}SheetState`). Собственный `{Feature}ViewModel` у sheet не создаётся — см. Фазу 3.
+
+### {Feature}Intent.kt
 
 ```kotlin
 package {package}.features.{feature}_sheet.intent
 
 import {package}.shared.mvi.Intent
 
-sealed interface {Feature}SheetIntent: Intent {
-    data object DismissClick: {Feature}SheetIntent
+sealed interface {Feature}Intent: Intent {
+    data object DismissClick: {Feature}Intent
 }
 ```
 
@@ -51,14 +56,14 @@ sealed interface {Feature}SheetIntent: Intent {
 - Для остальных действий (клик по элементу, primary/secondary action и т. д.) добавляй свои
   `data object` / `data class` записи; `data object` всегда идёт перед `data class`.
 
-### {Feature}SheetModel.kt (только если есть данные)
+### {Feature}Model.kt (только если есть данные)
 
 ```kotlin
 package {package}.features.{feature}_sheet.model
 
 import {package}.shared.mvi.Model
 
-data class {Feature}SheetModel(
+data class {Feature}Model(
     val showPrimaryAction: Boolean = false
 ): Model
 ```
@@ -72,11 +77,11 @@ package {package}
 
 @Composable
 fun {Feature}BottomSheet(
-    state: {Feature}SheetModel,
-    dispatch: ({Feature}SheetIntent) -> Unit
+    state: {Feature}Model,
+    dispatch: ({Feature}Intent) -> Unit
 ) {
     SharedModalBottomSheet(
-        onDismissRequest = { dispatch({Feature}SheetIntent.DismissClick) }
+        onDismissRequest = { dispatch({Feature}Intent.DismissClick) }
     ) {
         SharedLazyColumn(
             modifier = Modifier.fillMaxWidth(),
@@ -93,21 +98,21 @@ fun {Feature}BottomSheet(
                 {Feature}Card(
                     state = {Feature}CardState(
                         model = state.item,
-                        onClick = { dispatch({Feature}SheetIntent.ItemClick) }
+                        onClick = { dispatch({Feature}Intent.ItemClick) }
                     )
                 )
             }
             if (state.showSecondaryAction) {
                 item {
                     {Feature}SecondaryButton(
-                        onClick = { dispatch({Feature}SheetIntent.SecondaryActionClick) }
+                        onClick = { dispatch({Feature}Intent.SecondaryActionClick) }
                     )
                 }
             }
             if (state.showPrimaryAction) {
                 item {
                     Button(
-                        onClick = { dispatch({Feature}SheetIntent.PrimaryActionClick) },
+                        onClick = { dispatch({Feature}Intent.PrimaryActionClick) },
                         modifier = Modifier
                             .fillMaxWidth()
                             .height(56.dp),
@@ -130,7 +135,7 @@ fun {Feature}BottomSheet(
 @Preview
 @Composable
 private fun {Feature}BottomSheetPreview(
-    @PreviewParameter({Feature}SheetModelPreviewParameterProvider::class) state: {Feature}SheetModel
+    @PreviewParameter({Feature}ModelPreviewParameterProvider::class) state: {Feature}Model
 ) {
     Box(
         modifier = Modifier.fillMaxSize()
@@ -142,8 +147,8 @@ private fun {Feature}BottomSheetPreview(
     }
 }
 
-private class {Feature}SheetModelPreviewParameterProvider: PreviewParameterProvider<{Feature}SheetModel> {
-    override val values: Sequence<{Feature}SheetModel>
+private class {Feature}ModelPreviewParameterProvider: PreviewParameterProvider<{Feature}Model> {
+    override val values: Sequence<{Feature}Model>
         get() {
             val item = {Feature}ItemModel(
                 id = "sample-id",
@@ -152,12 +157,12 @@ private class {Feature}SheetModelPreviewParameterProvider: PreviewParameterProvi
             )
 
             return sequenceOf(
-                {Feature}SheetModel(
+                {Feature}Model(
                     item = item,
                     showPrimaryAction = true,
                     showSecondaryAction = false
                 ),
-                {Feature}SheetModel(
+                {Feature}Model(
                     item = item,
                     showPrimaryAction = false,
                     showSecondaryAction = true
@@ -210,11 +215,11 @@ reduce { it.copy(is{Feature}SheetVisible = true) }
 ### 3. Обработка intent'ов sheet в ViewModel экрана
 
 Добавь в `{Screen}Intent` экрана один case `On{Feature}SheetIntent`, оборачивающий весь
-`{Feature}SheetIntent` целиком — отдельный case на каждый intent sheet не создавай:
+`{Feature}Intent` целиком — отдельный case на каждый intent sheet не создавай:
 
 ```kotlin
 sealed interface {Screen}Intent: Intent {
-    data class On{Feature}SheetIntent(val intent: {Feature}SheetIntent): {Screen}Intent
+    data class On{Feature}SheetIntent(val intent: {Feature}Intent): {Screen}Intent
 }
 ```
 
@@ -225,7 +230,7 @@ override fun dispatch(intent: {Screen}Intent) {
     when (intent) {
         is {Screen}Intent.On{Feature}SheetIntent -> {
             when (intent.intent) {
-                is {Feature}SheetIntent.DismissClick -> {
+                is {Feature}Intent.DismissClick -> {
                     reduce { it.copy(is{Feature}SheetVisible = false) }
                 }
             }
@@ -265,15 +270,15 @@ fun {Screen}Screen(
 
 Когда sheet принимает `state`, не храни отдельную копию его Model в экране — вычисляй её свойством
 `get()` из уже существующих данных экрана. Имя свойства оканчивается на `State`, а не на `Model`
-(сам тип остаётся `{Feature}SheetModel`):
+(сам тип остаётся `{Feature}Model`):
 
 ```kotlin
 data class {Screen}Model(
     val {feature}Item: {Feature}Item = {Feature}Item.Empty,
     val is{Feature}SheetVisible: Boolean = false
 ): Model {
-    val {feature}SheetState: {Feature}SheetModel
-        get() = {Feature}SheetModel(
+    val {feature}SheetState: {Feature}Model
+        get() = {Feature}Model(
             item = {feature}Item
         )
 }
@@ -291,8 +296,8 @@ if (state.is{Feature}SheetVisible) {
 Правила:
 - Sheet не хранит собственный ViewModel; видимостью управляет `Boolean`-поле
   `is{Feature}SheetVisible` в `Model` вызывающего экрана.
-- Экран оборачивает весь `{Feature}SheetIntent` в один case `On{Feature}SheetIntent(val intent:
-  {Feature}SheetIntent)` своего `{Screen}Intent`; отдельных case'ов на каждый intent sheet не
+- Экран оборачивает весь `{Feature}Intent` в один case `On{Feature}SheetIntent(val intent:
+  {Feature}Intent)` своего `{Screen}Intent`; отдельных case'ов на каждый intent sheet не
   создавай — разбирай их вложенным `when` внутри `dispatch` ViewModel.
 - Рендери sheet в первой, публичной функции экрана, сразу после вызова
   `{Screen}ScreenContent(...)`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@michaelbel/cuckcoder-mcp",
-  "version": "1.6.11",
+  "version": "1.6.12",
   "description": "MCP server for Cuckcoder rules and skills",
   "type": "module",
   "main": "dist/index.js",

package/dist/github.js

@@ -1,23 +0,0 @@
-const BASE_RAW = "https://raw.githubusercontent.com";
-const BASE_API = "https://api.github.com";
-export async function fetchFile(owner, repo, branch, path) {
-    const url = `${BASE_RAW}/${owner}/${repo}/${branch}/${path}`;
-    const res = await fetch(url);
-    if (!res.ok) {
-        throw new Error(`Not found: ${path} (HTTP ${res.status})`);
-    }
-    return res.text();
-}
-export async function listTree(owner, repo, branch) {
-    const url = `${BASE_API}/repos/${owner}/${repo}/git/trees/${branch}?recursive=1`;
-    const res = await fetch(url, {
-        headers: { Accept: "application/vnd.github.v3+json" },
-    });
-    if (!res.ok) {
-        throw new Error(`Failed to fetch tree (HTTP ${res.status})`);
-    }
-    const data = (await res.json());
-    return data.tree
-        .filter((item) => item.type === "blob")
-        .map((item) => item.path);
-}