@michaelbel/cuckcoder-mcp 1.6.11

package/assets/skills/create-guide/references/validation.md

@@ -0,0 +1,59 @@
+# Validation Rules
+
+## Статическая проверка
+
+До Gradle-проверок запусти:
+
+```shell
+python scripts/validate_guide.py /path/to/project
+```
+
+Исправь ошибки структуры, инструкций, imports, package, источников и ссылок.
+
+## Gradle
+
+Обязательные задачи:
+
+```shell
+./gradlew :app:assembleDebug
+./gradlew :app:lintDebug
+```
+
+Если есть unit-тесты:
+
+```shell
+./gradlew :app:testDebugUnitTest
+```
+
+Если тема требует instrumented tests и среда предоставляет emulator/device, запусти их. Отсутствие emulator не блокирует публикацию только тогда, когда instrumented tests не заявлены обязательным сценарием.
+
+## Ручная проверка
+
+Запусти приложение и проверь каждый сценарий, когда среда позволяет. Для визуальных компонентов проверь light/dark theme, системный Back и состояния, заявленные в манифесте.
+
+## Cross-check
+
+После подготовки Notion сравни:
+
+- title и topic;
+- версии;
+- имена классов и функций;
+- package;
+- соответствие примеров кода реализованным samples без упоминания их имен в Notion;
+- ссылки на файлы;
+- экспериментальные opt-in;
+- ограничения;
+- источник адаптированного кода.
+
+## Отчёт
+
+Заполняй `.guidekit/validation-report.md` фактическими данными:
+
+- команда;
+- результат;
+- время;
+- commit SHA;
+- причина пропуска;
+- ручные проверки.
+
+Не ставь `passed`, если команда не запускалась или завершилась неуспешно.

package/assets/skills/create-guide/scripts/validate_guide.py

@@ -0,0 +1,167 @@
+#!/usr/bin/env python3
+
+import argparse
+from pathlib import Path
+import re
+import subprocess
+import sys
+
+
+REQUIRED_PATHS = (
+    ".github/CODEOWNERS",
+    ".github/FUNDING.yml",
+    ".github/workflows/ci.yml",
+    ".guidekit/manifest.yaml",
+    ".guidekit/research.md",
+    ".guidekit/implementation-plan.md",
+    ".guidekit/SOURCES.md",
+    ".guidekit/validation-report.md",
+    ".idea/icon.svg",
+    "AGENTS.md",
+    "CLAUDE.md",
+    "GEMINI.md",
+    "README.md",
+    "app/build.gradle.kts",
+    "build.gradle.kts",
+    "gradle/libs.versions.toml",
+    "gradlew",
+    "settings.gradle.kts",
+)
+
+WILDCARD_IMPORT = re.compile(r"^import\s+[\w.]+\.\*$", re.MULTILINE)
+PACKAGE_DECLARATION = re.compile(r"^package\s+([\w.]+)", re.MULTILINE)
+SAMPLE_DIRECTORY = re.compile(r"sample\d{2}_[A-Za-z0-9_]+$")
+
+
+def instruction_link_error(path: Path) -> str | None:
+    if path.is_symlink():
+        if path.readlink() != Path("AGENTS.md"):
+            return f"{path.name} must point to AGENTS.md"
+        return None
+
+    if path.is_file() and path.read_text(encoding="utf-8").strip() == "AGENTS.md":
+        return None
+
+    return f"{path.name} must be a symlink to AGENTS.md"
+
+
+def run_command(project: Path, command: list[str]) -> tuple[bool, str]:
+    result = subprocess.run(
+        command,
+        cwd=project,
+        check=False,
+        text=True,
+    )
+    return result.returncode == 0, " ".join(command)
+
+
+def validate(project: Path) -> list[str]:
+    errors: list[str] = []
+
+    for relative_path in REQUIRED_PATHS:
+        path = project / relative_path
+        if not path.exists() and not path.is_symlink():
+            errors.append(f"Missing required path: {relative_path}")
+
+    for name in ("CLAUDE.md", "GEMINI.md"):
+        error = instruction_link_error(project / name)
+        if error:
+            errors.append(error)
+
+    agents_path = project / "AGENTS.md"
+    if agents_path.exists():
+        agents = agents_path.read_text(encoding="utf-8")
+        for phrase in ("cuckcoder", ".guidekit/manifest.yaml", ".guidekit/SOURCES.md"):
+            if phrase not in agents:
+                errors.append(f"AGENTS.md does not mention: {phrase}")
+
+    manifest_path = project / ".guidekit/manifest.yaml"
+    if manifest_path.exists():
+        manifest = manifest_path.read_text(encoding="utf-8")
+        for section in ("guide:", "topic:", "repository:", "scenarios:", "notion:", "validation:"):
+            if section not in manifest:
+                errors.append(f"Manifest misses section: {section}")
+        if re.search(r"<[^>\n]+>", manifest):
+            errors.append("Manifest still contains template placeholders")
+
+    source_root = project / "app/src"
+    kotlin_files = tuple(source_root.rglob("*.kt")) if source_root.exists() else ()
+    if not kotlin_files:
+        errors.append("No Kotlin source files found under app/src")
+
+    for kotlin_file in kotlin_files:
+        content = kotlin_file.read_text(encoding="utf-8")
+        relative_path = kotlin_file.relative_to(project)
+        if WILDCARD_IMPORT.search(content):
+            errors.append(f"Wildcard import in {relative_path}")
+        package_match = PACKAGE_DECLARATION.search(content)
+        if package_match and not package_match.group(1).startswith("org.michaelbel."):
+            errors.append(f"Unexpected package in {relative_path}: {package_match.group(1)}")
+
+    sample_directories = {
+        path
+        for kotlin_file in kotlin_files
+        for path in kotlin_file.parents
+        if path != source_root and SAMPLE_DIRECTORY.fullmatch(path.name)
+    }
+    readme_path = project / "README.md"
+    if readme_path.exists():
+        readme = readme_path.read_text(encoding="utf-8")
+        if "shields.io/github/last-commit/" not in readme:
+            errors.append("README misses the last-commit badge")
+        if len(sample_directories) > 1 and "## Samples" not in readme:
+            errors.append("Catalog project README misses the Samples section")
+
+    sources_path = project / ".guidekit/SOURCES.md"
+    if sources_path.exists():
+        sources = sources_path.read_text(encoding="utf-8")
+        if "https://" not in sources:
+            errors.append("SOURCES.md does not contain any source URL")
+        if re.search(r"<[^>\n]+>", sources):
+            errors.append("SOURCES.md still contains template placeholders")
+
+    return errors
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(description="Validate an Android guide repository")
+    parser.add_argument("project", type=Path)
+    parser.add_argument("--run-gradle", action="store_true")
+    args = parser.parse_args()
+
+    project = args.project.resolve()
+    if not project.is_dir():
+        print(f"ERROR: Project directory does not exist: {project}")
+        return 1
+
+    errors = validate(project)
+    if errors:
+        for error in errors:
+            print(f"ERROR: {error}")
+        return 1
+
+    if args.run_gradle:
+        gradlew = project / "gradlew"
+        commands = (
+            [str(gradlew), ":app:assembleDebug"],
+            [str(gradlew), ":app:lintDebug"],
+        )
+        for command in commands:
+            passed, rendered = run_command(project, command)
+            if not passed:
+                print(f"ERROR: Gradle command failed: {rendered}")
+                return 1
+
+        unit_test_sources = tuple((project / "app/src/test").rglob("*.kt"))
+        if unit_test_sources:
+            passed, rendered = run_command(project, [str(gradlew), ":app:testDebugUnitTest"])
+            if not passed:
+                print(f"ERROR: Gradle command failed: {rendered}")
+                return 1
+
+    print(f"Guide repository is valid: {project}")
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/assets/skills/create-guide/templates/guide-manifest.yaml

@@ -0,0 +1,67 @@
+schema_version: 1
+
+guide:
+  id: <topic-slug>
+  title: <Topic>
+  notion_title: Гайд по <Topic>. <Практический результат>
+  audience: middle_android_developer
+  language: ru
+  status: draft
+
+topic:
+  kind: android_api
+  api_status: <stable|alpha|experimental|platform>
+  primary_components:
+    - <Component>
+  related_components: []
+  artifact_coordinates: []
+  platform_api_level: null
+
+research:
+  researched_at: <YYYY-MM-DD>
+  primary_sources: []
+  androidx:
+    used: false
+    repository: https://github.com/androidx/androidx
+    ref: null
+    paths: []
+    usage: <reference|adapted|copied|null>
+
+repository:
+  owner: michaelbel
+  name: <Topic>
+  visibility: public
+  package: org.michaelbel.<topic>
+  template: https://github.com/michaelbel/MyApplication
+  template_ref: <commit-sha>
+  project_mode: <catalog|scenario|single>
+  default_branch: <branch>
+
+android:
+  min_sdk: <inherited-or-required-value>
+  compile_sdk: <inherited-value>
+  target_sdk: <inherited-value>
+  jdk: 21
+  ui: compose
+  architecture: minimal_for_topic
+
+scenarios:
+  - id: <scenario-id>
+    title: <Scenario title>
+    demonstrates:
+      - <API or behavior>
+
+notion:
+  data_source_name: POSTS
+  existing_page_policy: update_in_place
+  page_id: null
+  page_url: null
+
+validation:
+  required:
+    - :app:assembleDebug
+    - :app:lintDebug
+  optional: []
+
+decisions: []
+known_limitations: []

package/assets/skills/create-guide/templates/implementation-plan.md

@@ -0,0 +1,30 @@
+# Implementation Plan
+
+Тема: <Topic>
+Тип проекта: <catalog | scenario | single>
+
+## Сценарии
+
+### 01. <Название>
+
+- Демонстрирует:
+- Файлы:
+- UI-состояния:
+- Проверка:
+
+## Общая инфраструктура
+
+- Зависимости:
+- Навигация:
+- Тема:
+- Тесты:
+
+## Notion mapping
+
+- Раздел:
+- Source file:
+- GitHub URL:
+
+## Не входит в scope
+
+- ...

package/assets/skills/create-guide/templates/notion-page.md

@@ -0,0 +1,46 @@
+<Короткое объяснение точного API и проблемы, которую он решает. Объясни специальные термины через наблюдаемое поведение. Если широкая тема поддерживает несколько вариантов, явно зафиксируй выбранный вариант.>
+
+<Критичное требование, статус API или ограничение, если оно есть.>
+
+<empty-block/>
+## Главная идея
+
+<Ментальная модель и взаимодействие компонентов.>
+
+<empty-block/>
+## Настройка манифеста
+
+<Добавляй этот раздел только когда API требует permissions, services, activities или providers.>
+
+```xml
+<uses-permission android:name="<permission>" />
+```
+
+<empty-block/>
+## <Основной компонент>
+
+### Что делает
+
+### Как работает
+
+### Важные параметры и состояния
+
+### Минимальный пример
+
+```kotlin
+// Код существует в GitHub-репозитории.
+```
+
+### Ошибки и важные условия
+
+<empty-block/>
+## <Следующий компонент или метод API>
+
+<Описание API и пример кода из проекта. Не делай эту секцию toggle.>
+
+<empty-block/>
+## Документация
+
+[<Официальный заголовок страницы> | Android Developers](<documentation-url>)
+[<Официальный заголовок release notes> | Android Developers](<release-notes-url>)
+Репозиторий – [<repository-url>](<repository-url>)

package/assets/skills/create-guide/templates/repository/AGENTS.md

@@ -0,0 +1,7 @@
+# Repository Guidelines
+
+- Follow the `cuckcoder` MCP instructions for all code generation and review tasks.
+- Read `.guidekit/manifest.yaml` before changing the scope, package, versions or scenarios.
+- Keep README, `.guidekit/SOURCES.md`, `.guidekit/validation-report.md` and the linked Notion guide consistent with the implementation.
+- Do not add dependencies or architectural layers that are unrelated to the guide topic.
+- Re-run the required validation tasks before publishing changes.

package/assets/skills/create-guide/templates/repository/README.md

@@ -0,0 +1,32 @@
+[![last-commit](https://img.shields.io/github/last-commit/michaelbel/<Repository>?style=for-the-badge&logo=github&labelColor=3F464F)](https://github.com/michaelbel/<Repository>/commits)
+
+<Topic>
+=
+
+<One or two sentences describing the Android samples and the API they demonstrate.>
+
+<div align="left">
+    <img src=".github/app.jpg" alt="Application">
+</div>
+
+## Technologies
+
+[![Android](https://img.shields.io/badge/Android-50AE55?style=for-the-badge&logo=android&logoColor=F6F6F6)](https://github.com/michaelbel/<Repository>)
+[![Kotlin](https://img.shields.io/badge/Kotlin-7F52FF?style=for-the-badge&logo=kotlin&logoColor=white)](https://github.com/michaelbel/<Repository>)
+[![Compose](https://img.shields.io/badge/Compose-4285F4?style=for-the-badge&logo=jetpackcompose&logoColor=white)](https://github.com/michaelbel/<Repository>)
+
+## Samples
+
+| # | Sample | Description |
+|---|--------|-------------|
+| 01 | [`<API>`](app/src/main/kotlin/org/michaelbel/<package>/sample01_<Name>/Sample01App.kt) | <What this sample demonstrates> |
+
+## Build
+
+```shell
+./gradlew :app:assembleDebug
+```
+
+## Sources
+
+See [`.guidekit/SOURCES.md`](.guidekit/SOURCES.md).

package/assets/skills/create-guide/templates/repository/SOURCES.md

@@ -0,0 +1,32 @@
+# Sources
+
+Исследовано: <YYYY-MM-DD>
+
+## Official documentation
+
+- URL:
+- Использовано:
+
+## Release notes
+
+- URL:
+- Версия:
+
+## AndroidX
+
+- Repository: https://github.com/androidx/androidx
+- Ref or commit SHA:
+- Path:
+- URL:
+- Использовано:
+- Usage: <reference | adapted | copied>
+- Изменения:
+
+## Additional sources
+
+- URL:
+- Почему источник нужен:
+
+## Third-party notices
+
+<Укажи лицензию и notices для adapted/copied материалов или напиши `None`.>

package/assets/skills/create-guide/templates/validation-report.md

@@ -0,0 +1,30 @@
+# Validation Report
+
+Commit: <sha>
+Дата: <YYYY-MM-DD>
+
+## Static checks
+
+- `python scripts/validate_guide.py .` — <passed|failed|not-run>
+
+## Gradle
+
+- `./gradlew :app:assembleDebug` — <passed|failed|not-run>
+- `./gradlew :app:lintDebug` — <passed|failed|not-run>
+- `./gradlew :app:testDebugUnitTest` — <passed|failed|not-applicable|not-run>
+
+## Manual scenarios
+
+- <Scenario> — <passed|failed|not-run>
+
+## Notion cross-check
+
+- Versions — <passed|failed|not-run>
+- Class and function names — <passed|failed|not-run>
+- GitHub paths — <passed|failed|not-run>
+- Code snippets — <passed|failed|not-run>
+- Known limitations — <passed|failed|not-run>
+
+## Notes
+
+- ...

package/assets/skills/create-guide/tests/test_validate_guide.py

@@ -0,0 +1,97 @@
+from pathlib import Path
+import tempfile
+import unittest
+
+from scripts.validate_guide import REQUIRED_PATHS, validate
+
+
+class ValidateGuideTest(unittest.TestCase):
+
+    def create_project(self, root: Path) -> Path:
+        for relative_path in REQUIRED_PATHS:
+            path = root / relative_path
+            path.parent.mkdir(parents=True, exist_ok=True)
+            if relative_path in ("CLAUDE.md", "GEMINI.md"):
+                path.symlink_to("AGENTS.md")
+            else:
+                path.write_text("\n", encoding="utf-8")
+
+        (root / "AGENTS.md").write_text(
+            "Use cuckcoder. Read .guidekit/manifest.yaml and .guidekit/SOURCES.md.\n",
+            encoding="utf-8",
+        )
+        (root / ".guidekit/manifest.yaml").write_text(
+            "\n".join(
+                (
+                    "guide:",
+                    "  id: navigation3",
+                    "topic:",
+                    "  kind: android_api",
+                    "repository:",
+                    "  name: Navigation3",
+                    "scenarios:",
+                    "  - id: basic",
+                    "notion:",
+                    "  data_source_name: POSTS",
+                    "  existing_page_policy: update_in_place",
+                    "validation:",
+                    "  required:",
+                    "    - :app:assembleDebug",
+                )
+            ),
+            encoding="utf-8",
+        )
+        (root / ".guidekit/SOURCES.md").write_text(
+            "https://developer.android.com/\n",
+            encoding="utf-8",
+        )
+        (root / "README.md").write_text(
+            "https://img.shields.io/github/last-commit/michaelbel/Navigation3\n",
+            encoding="utf-8",
+        )
+
+        kotlin_path = root / "app/src/main/kotlin/org/michaelbel/navigation3/MainActivity.kt"
+        kotlin_path.parent.mkdir(parents=True, exist_ok=True)
+        kotlin_path.write_text(
+            "\n".join(
+                (
+                    "package org.michaelbel.navigation3",
+                    "",
+                    "import androidx.activity.ComponentActivity",
+                    "",
+                    "class MainActivity: ComponentActivity()",
+                )
+            ),
+            encoding="utf-8",
+        )
+        return kotlin_path
+
+    def test_valid_project_has_no_errors(self) -> None:
+        with tempfile.TemporaryDirectory() as directory:
+            project = Path(directory)
+            self.create_project(project)
+
+            self.assertEqual([], validate(project))
+
+    def test_wildcard_import_is_rejected(self) -> None:
+        with tempfile.TemporaryDirectory() as directory:
+            project = Path(directory)
+            kotlin_path = self.create_project(project)
+            kotlin_path.write_text(
+                "\n".join(
+                    (
+                        "package org.michaelbel.navigation3",
+                        "",
+                        "import androidx.compose.runtime.*",
+                    )
+                ),
+                encoding="utf-8",
+            )
+
+            errors = validate(project)
+
+            self.assertTrue(any("Wildcard import" in error for error in errors))
+
+
+if __name__ == "__main__":
+    unittest.main()

package/assets/skills/create-ktor-endpoint/SKILL.md

@@ -0,0 +1,33 @@
+---
+name: create-ktor-endpoint
+description: >-
+  Use when пользователь просит добавить Ktor API endpoint, request/response-модели или настроить
+  отдельный HttpClient для нового backend. Не используй для Room, mapper, use case, WebSocket или
+  полного потока данных от API до UI.
+metadata:
+  author: michaelbel
+---
+
+# Создание Ktor endpoint
+
+Сначала найди подходящий `NetworkService`, существующий `HttpClient`/qualifier и соседний endpoint.
+Повторяй локальные соглашения авторизации, base URL, headers, query/path/body и обработки
+`HttpResponse`; новый client создавай только когда существующий не подходит по backend или policy.
+
+## Реализация
+
+- Добавь метод в тематический `NetworkService` и используй точный HTTP method/path контракта.
+- Создай только необходимые request/response-модели, каждую в отдельном файле.
+- Имена моделей заканчивай на `Request` и `Response`.
+- Аннотируй каждую API-модель `@Serializable`, а каждое сериализуемое поле — `@SerialName` с точным
+  именем из wire-контракта.
+- Выражай path/query/header/body/multipart явно и сохраняй nullable/optional семантику API; не
+  подставляй domain defaults в transport-модель.
+- Не добавляй mapper, Room-запись или `UseCase`, если они не входят в запрос пользователя.
+
+Если нужен новый client, подключи его через существующий DI-подход и настрой только необходимые
+base URL, JSON, authentication, timeout, logging/Chucker параметры. Не логируй токены и чувствительные
+body.
+
+Проверь компиляцию модуля и существующие mock/API contract tests; для нового endpoint добавь тест,
+если в проекте уже используется MockEngine или аналогичный шаблон.