fchek 1.0.0

package/skills/context.md

@@ -0,0 +1,116 @@
+# skill: fchek context — дамп символов проекта
+
+## Что делает
+
+Извлекает все функции, классы, методы и типы из кодовой базы через AST (Python)
+или regex (JS/TS/Rust/C/Go). Строит `name_index` для быстрого поиска дублей.
+
+**Вызывай ДО написания нового кода** — чтобы не создавать функцию которая уже существует.
+
+## Поддерживаемые языки
+
+| Язык | Метод | Что извлекает |
+|---|---|---|
+| Python | AST (точный) | functions, async_functions, classes + methods |
+| JS/TS | regex | functions, arrow_functions, classes, methods, exports |
+| Rust | regex | fn, struct, enum, trait, impl, type, const |
+| C/C++ | regex | functions, classes, structs, macros |
+| Go | regex | functions, structs, interfaces |
+| **C#** | **regex** | **classes, methods, properties, interfaces, enum, record** |
+
+## Синтаксис
+
+```bash
+fchek context <file_or_dir> [--names-only] [--depth=N]
+```
+
+- `--names-only` — только список имён (компактно, без деталей)
+- `--depth=N` — глубина обхода папок (default: 5)
+
+## Вывод JSON
+
+### Полный
+```json
+{
+  "status": "ok",
+  "command": "context",
+  "data": {
+    "target": "/project/src",
+    "total_files": 12,
+    "total_symbols": 87,
+    "files": [
+      {
+        "file": "/project/src/auth.py",
+        "lang": "python",
+        "symbols": [
+          { "kind": "function", "name": "validate_token", "line": 15, "args": ["token", "secret"] },
+          { "kind": "class",    "name": "AuthManager",    "line": 42, "methods": ["login", "logout"] }
+        ]
+      }
+    ],
+    "name_index": {
+      "validate_token": [{ "file": "src/auth.py", "kind": "function", "line": 15 }]
+    },
+    "duplicates": []
+  }
+}
+```
+
+### С --names-only
+```json
+{
+  "data": {
+    "total_symbols": 87,
+    "names": ["AuthManager", "login", "logout", "validate_token", ...],
+    "duplicates": []
+  }
+}
+```
+
+## Как AI должен использовать это
+
+### Сценарий: "Хочу добавить функцию parse_config()"
+
+```bash
+# 1. Проверить — уже есть такая функция?
+fchek context src/ --names-only
+
+# 2. Смотрю data.names — есть ли "parse_config"?
+# Нашёл → НЕ создаю дубль → использую существующую или выбираю другое имя
+
+# 3. Если нет — смотрю data.name_index на похожие имена
+# ("parse_cfg", "loadConfig", "read_config" — может быть уже есть аналог)
+```
+
+### Сценарий: "Рефакторинг — найти всё что использует старое имя"
+
+```bash
+fchek context src/
+# data.name_index["old_function_name"] → все файлы где оно есть
+# Потом: fchek goto src/auth.py:42 → все ссылки
+```
+
+### Алгоритм принятия решений
+
+```
+ЕСЛИ name_index содержит имя которое собираюсь создать:
+  → НЕ создаю дубль
+  → Читаю существующую реализацию: fchek goto <file:line>
+  → Решаю: использовать существующую ИЛИ выбрать другое имя
+
+ЕСЛИ duplicates не пустой:
+  → В проекте уже есть конфликты имён
+  → Сообщаю об этом перед добавлением нового кода
+
+ЕСЛИ total_symbols = 0:
+  → Папка пустая или нет поддерживаемых файлов
+```
+
+### Ключевые поля
+
+| Поле | Что означает |
+|---|---|
+| `name_index` | Словарь имя → [{file, kind, line}] |
+| `duplicates` | Имена встречающиеся в нескольких файлах |
+| `total_symbols` | Общее число найденных символов |
+| `files[].symbols` | Полный список символов в каждом файле |

package/skills/convention.md

@@ -0,0 +1,143 @@
+# skill: fchek convention — паттерны проекта
+
+## Что делает
+
+Сканирует проект и извлекает его неписаные правила:
+как обрабатываются ошибки, какой стиль именования, где лежат тесты, что используется для логирования.
+
+**Вызывай при первом входе в незнакомый проект** — чтобы новый код не выбивался из общего стиля.
+
+## Поддерживаемые языки
+
+| Язык | Инструменты | Что анализирует |
+|---|---|---|
+| Python | ruff check | error_handling, naming, async, imports, logging, test_locations |
+| JS/TS | regex | error_handling, naming, async, imports, logging, test_locations |
+| Rust | regex | error_handling, error_style_summary, async (tokio/async-std), logging |
+| C/C++ | regex | error_handling (errno/throw/assert), naming, logging |
+| Go | regex | error_handling (if err!=nil / panic), async (goroutines), logging |
+| **C#** | **regex** | **framework detection, error_handling, async (Task/CancellationToken), logging (ILogger/Serilog/NLog)** |
+
+## Синтаксис
+
+```bash
+fchek convention <project_dir>
+```
+
+## Вывод JSON
+
+```json
+{
+  "status": "ok",
+  "command": "convention",
+  "data": {
+    "project": "/project",
+    "languages": ["python", "javascript"],
+    "structure": {
+      "has_tests_dir": true,
+      "has_src_dir": true,
+      "has_ci": true,
+      "has_linter_config": true,
+      "config_files": ["package.json", "pyproject.toml"]
+    },
+    "conventions": [
+      {
+        "lang": "python",
+        "naming_style": "snake",
+        "test_files": 8,
+        "test_locations": ["tests/test_auth.py", "tests/test_utils.py"],
+        "error_handling": [
+          { "pattern": "try/except",   "occurrences": 24 },
+          { "pattern": "raise custom", "occurrences": 11 }
+        ],
+        "async_patterns": [
+          { "pattern": "async def",    "occurrences": 15 },
+          { "pattern": "await",        "occurrences": 31 }
+        ],
+        "logging_style": [
+          { "pattern": "logging module", "occurrences": 42 }
+        ]
+      }
+    ],
+    "summary": "Project uses: python. python: naming=snake"
+  }
+}
+```
+
+## Как AI должен использовать это
+
+### При первом входе в проект — обязательно
+
+```bash
+fchek convention .
+```
+
+Затем применяй правила при написании кода:
+
+```
+naming_style = "snake"   → пиши get_user_data(), не getUserData()
+naming_style = "camel"   → пиши getUserData(), не get_user_data()
+
+error_handling[0] = "try/except"   → используй try/except, не коды возврата
+error_handling[0] = "Result<T,E>"  → возвращай Result, не паникуй
+
+logging_style[0] = "logging module" → используй logging.info(), не print()
+logging_style[0] = "console.log"    → используй console.log()
+
+async_patterns[0] = "async def"     → проект асинхронный, используй async/await
+```
+
+### Тесты — где их создавать
+
+```
+test_locations[0] = "tests/test_auth.py"
+→ новые тесты кладу в tests/
+→ файлы называю test_<module>.py
+
+test_locations[0] = "src/__tests__/auth.test.ts"
+→ тесты рядом с кодом в __tests__/
+→ файлы <module>.test.ts
+```
+
+### Rust — error_style_summary
+
+```
+"unwrap-heavy (consider ? operator)"
+→ проект использует .unwrap() — спорный стиль
+→ для нового кода используй ? оператор и Result<T,E>
+
+"Result<T,E> with ? operator"
+→ правильный стиль — продолжай в том же духе
+```
+
+### C# — уникальные поля
+
+`framework` — автоопределение по импортам:
+```
+"ASP.NET Core" → Microsoft.AspNetCore в using
+"WPF"          → System.Windows или .xaml файлы
+"MAUI/Xamarin" → Xamarin или MAUI namespace
+"Unity"        → UnityEngine namespace
+"Blazor"       → Blazor namespace
+```
+
+Используй `framework` чтобы понять контекст — в WPF не нужен HttpClient, в ASP.NET не нужен DispatcherTimer.
+
+`logging_style` для C#:
+```
+"ILogger"  → Microsoft.Extensions.Logging (ASP.NET Core стандарт)
+"Serilog"  → структурированное логирование
+"NLog"     → классический логгер
+```
+Никогда не вводи новую logging библиотеку если уже есть существующая.
+
+### Ключевые поля
+
+| Поле | Что означает |
+|---|---|
+| `naming_style` | snake / camel / pascal |
+| `error_handling[0]` | Самый частый паттерн обработки ошибок |
+| `test_locations` | Куда класть новые тесты |
+| `logging_style[0]` | Какую библиотеку логирования использует проект |
+| `structure.has_linter_config` | Есть ли конфиг линтера — если да, линтер строже |
+| `async_patterns` | Какой async-стиль использует проект |

package/skills/coverage.md

@@ -0,0 +1,99 @@
+# skill: fchek coverage — покрытие кода тестами
+
+## Что делает
+
+Запускает тесты и показывает, какие строки кода **не покрыты** ни одним тестом.
+Незаменимо перед рефакторингом — не трогай то, что не проверено.
+
+## Поддерживаемые языки
+
+| Язык | Инструмент | Установка |
+|---|---|---|
+| Python (.py) | coverage.py | `pip install coverage` |
+| C/C++ (.c .cpp) | gcov | `apt install gcc` |
+| Rust (Cargo.toml) | cargo-tarpaulin (Linux) / cargo-llvm-cov | `cargo install cargo-tarpaulin` |
+| JS/TS (package.json) | c8 | `npm install -g c8` |
+
+## Синтаксис
+
+```bash
+fchek coverage <file_or_dir> [--html] [--threshold=<0-100>]
+```
+
+- `--html` — сгенерировать HTML-отчёт в `./coverage_html/`
+- `--threshold=80` — если покрытие ниже N% → `status: "error"`
+
+## Вывод JSON
+
+```json
+{
+  "status": "ok",
+  "command": "coverage",
+  "data": {
+    "file": "/project/test_auth.py",
+    "lang": "python",
+    "tool": "coverage.py",
+    "total_pct": 74,
+    "threshold": 80,
+    "passed_threshold": false,
+    "files": [
+      { "file": "src/auth.py", "stmts": 120, "missed": 31, "coverage_pct": 74, "missing_lines": "45-52, 88-95" }
+    ],
+    "uncovered_files": [ ... ],
+    "html_report": "/project/coverage_html/index.html"
+  }
+}
+```
+
+## Как AI должен использовать это
+
+### Сценарий: "Перед рефакторингом — найти непокрытый код"
+
+```bash
+# 1. Запусти coverage
+fchek coverage tests/
+
+# 2. Смотри data.uncovered_files — это зоны без тестов
+# 3. Для каждого файла смотри missing_lines
+# 4. Перейди к непокрытой строке через goto
+fchek goto src/auth.py:45
+# 5. Оцени риск изменения непокрытого кода
+```
+
+### Сценарий: "Поставить gates для CI"
+
+```bash
+fchek coverage . --threshold=80
+# status: "error" если coverage < 80% → CI должен упасть
+```
+
+### Алгоритм принятия решений
+
+```
+ЕСЛИ total_pct < threshold:
+  → status будет "error"
+  → смотри uncovered_files → предложи добавить тесты
+
+ЕСЛИ total_pct = 100:
+  → полное покрытие, но не значит что тесты хорошие
+
+ЕСЛИ coverage.py не нашёл файлы:
+  → убедись что передаёшь файл с тестами, а не с кодом
+```
+
+### Ключевые поля для AI
+
+| Поле | Что означает |
+|---|---|
+| `total_pct` | Общее покрытие в процентах |
+| `uncovered_files[]` | Файлы с покрытием < 100% |
+| `missing_lines` | Строки которые не выполнялись ни разу |
+| `passed_threshold` | true/false — прошёл ли threshold |
+| `html_report` | Путь к HTML — можно открыть для визуализации |
+
+## Платформенные ограничения
+
+- `gcov` — только Linux (нужен gcc с `-fprofile-arcs`)
+- `cargo-tarpaulin` — только Linux; на macOS/Windows используй `cargo-llvm-cov`
+- `c8` — работает везде где есть Node.js и npm test
+- `coverage.py` — работает везде

package/skills/csharp.md

@@ -0,0 +1,97 @@
+# skill: fchek + C# — полная поддержка
+
+## Поддержка по командам
+
+| Команда | Статус | Инструмент |
+|---|---|---|
+| `fchek context .` | ✓ | regex AST — классы, методы, properties, интерфейсы |
+| `fchek convention .` | ✓ | Анализ паттернов — framework, errors, async, logging |
+| `fchek run File.cs` | ✓ | `dotnet run` |
+| `fchek secrets .` | ✓ | Regex, .dll/bin/obj игнорируются |
+| `fchek lint .` | ✓ | `dotnet format` + `dotnet build` warnings |
+| `fchek coverage .` | ✓ | `dotnet test` + coverlet (XPlat Code Coverage) |
+| `fchek deps .` | ✓ | `dotnet list package` — outdated + vulnerable |
+| `fchek goto File.cs:42` | ✓ | Grep-based symbol search по всему проекту |
+| `fchek profile` | — | Нет (используй dotnet-trace / VS Profiler) |
+| `fchek race` | — | Нет (используй VS Diagnostic Tools) |
+| `fchek fuzz` | — | Нет (используй SharpFuzz вручную) |
+
+**Требует:** .NET SDK установлен (`fchek doctor` покажет статус `dotnet`).
+
+## Workflow для C# проекта
+
+```bash
+# 1. Узнать стиль проекта
+fchek convention .
+# → framework: ASP.NET Core / WPF / Unity / Blazor / MAUI
+# → error_handling, async_patterns, logging_style
+
+# 2. Проверить существующие символы (избежать дублей)
+fchek context src/ --names-only
+
+# 3. Написать код, затем:
+fchek run Program.cs          # dotnet run — exit_code = 0?
+
+# 4. Линт и форматирование
+fchek lint .                  # dotnet format + build warnings
+
+# 5. Покрытие тестами
+fchek coverage .              # dotnet test + coverlet
+
+# 6. NuGet зависимости
+fchek deps .                  # outdated + vulnerable packages
+
+# 7. Поиск символа
+fchek goto Services/UserService.cs:42
+
+# 8. Секреты перед коммитом
+fchek secrets .               # .dll/bin/obj игнорируются
+```
+
+## Как читать вывод fchek convention для C#
+
+`framework` — автоопределение по using/namespace:
+- `ASP.NET Core` → DI через constructor, `ILogger<T>`, `IConfiguration`
+- `WPF` → MVVM, `INotifyPropertyChanged`, `DispatcherTimer`
+- `Unity` → `MonoBehaviour`, lifecycle methods
+- `Blazor` → компонентный подход
+
+`logging_style[0]`:
+- `ILogger` → продолжай использовать `_logger.LogInformation(...)`
+- `Console.Write` → проект использует Console — вероятно legacy или CLI app
+
+## Правила для C# кода
+
+### Секреты
+```csharp
+// ❌
+var connStr = "Server=prod;Password=Secret123;";
+
+// ✅
+var connStr = _configuration.GetConnectionString("DefaultConnection");
+// или
+var connStr = Environment.GetEnvironmentVariable("DB_CONNECTION_STRING");
+```
+
+### Async
+```csharp
+// ❌ Sync внутри async context
+var result = GetDataAsync().Result;
+
+// ✅
+var result = await GetDataAsync(cancellationToken);
+```
+
+### Error handling
+```csharp
+// ❌ Глотать исключения
+try { DoSomething(); } catch { }
+
+// ✅ Логировать + пробрасывать или custom exception
+try { await DoSomethingAsync(ct); }
+catch (Exception ex) when (ex is not OperationCanceledException)
+{
+    _logger.LogError(ex, "Failed to do something");
+    throw new MyDomainException("...", ex);
+}
+```

package/skills/db.md

@@ -0,0 +1,66 @@
+# skill: fchek db — Инспекция и запросы к БД (SQLite)
+
+## Что делает
+
+Позволяет просматривать схему таблиц SQLite баз данных и выполнять произвольные SQL-запросы прямо из командной строки.
+
+## Синтаксис
+
+```bash
+# Получить схему базы данных (таблицы, колонки, индексы)
+fchek db schema <db_path>
+
+# Выполнить SQL запрос
+fchek db query <db_path> "<sql_query>"
+```
+
+## Вывод JSON
+
+### db schema
+```json
+{
+  "status": "ok",
+  "command": "db",
+  "data": {
+    "database": "data.db",
+    "tables": [
+      {
+        "name": "users",
+        "columns": [
+          { "name": "id", "type": "INTEGER", "notnull": false, "dflt_value": null, "pk": true },
+          { "name": "email", "type": "TEXT", "notnull": true, "dflt_value": null, "pk": false }
+        ],
+        "indexes": ["sqlite_autoindex_users_1"]
+      }
+    ]
+  }
+}
+```
+
+### db query
+```json
+{
+  "status": "ok",
+  "command": "db",
+  "data": {
+    "query": "SELECT * FROM users",
+    "count": 1,
+    "rows": [
+      { "id": 1, "email": "alice@example.com" }
+    ]
+  }
+}
+```
+
+## КАК AI ДОЛЖЕН ИСПОЛЬЗОВАТЬ ЭТО
+
+### Сценарии
+
+1. **Проверка схемы**: если код падает с ошибкой базы данных (например, `no such column`), исследуй схему:
+   ```bash
+   fchek db schema app.db
+   ```
+2. **Проверка данных**: убедись, что транзакция или миграция сработала корректно:
+   ```bash
+   fchek db query app.db "SELECT * FROM migrations"
+   ```

package/skills/deps-check.md

@@ -0,0 +1,135 @@
+# skill: fchek deps-check — актуальность API библиотеки
+
+## Что делает
+
+Делает live-запрос к реестру пакетов (npm / PyPI / crates.io) и возвращает:
+- установленную версию vs последнюю
+- deprecated флаги на версиях
+- yanked версии (Rust)
+- предупреждения о deprecated методах из changelog
+
+**Закрывает проблему галлюцинаций API** — данные из реального реестра, не из памяти модели.
+
+## Поддерживаемые реестры
+
+| Язык | Реестр | Авто-определение |
+|---|---|---|
+| Node.js | registry.npmjs.org | `package.json` в папке |
+| Python | pypi.org | `requirements.txt` / `pyproject.toml` |
+| Rust | crates.io | `Cargo.toml` в папке |
+
+## Синтаксис
+
+```bash
+fchek deps-check <lib> [--lang=node|python|rust] [--show-changelog]
+```
+
+- `--lang` — принудительно указать язык (если авто-определение не сработало)
+- `--show-changelog` — добавить ссылку на changelog
+
+## Вывод JSON
+
+### Online (есть сеть)
+```json
+{
+  "status": "ok",
+  "command": "deps-check",
+  "data": {
+    "lib": "requests",
+    "registry": "pypi",
+    "installed_version": "2.28.0",
+    "latest_version": "2.34.2",
+    "up_to_date": false,
+    "is_deprecated": false,
+    "deprecation_notices": [],
+    "recent_versions": ["2.34.2", "2.34.1", "2.34.0"],
+    "requires_python": ">=3.8",
+    "description": "Python HTTP for Humans."
+  }
+}
+```
+
+### Offline (нет сети)
+```json
+{
+  "data": {
+    "offline": true,
+    "offline_note": "No internet connection. Showing installed version only.",
+    "installed_version": "2.28.0",
+    "latest_version": null,
+    "up_to_date": null
+  }
+}
+```
+
+### npm — deprecated версия
+```json
+{
+  "data": {
+    "lib": "request",
+    "installed_deprecated": "DEPRECATED! Use axios or node-fetch instead.",
+    "deprecated_versions": [
+      { "version": "2.88.2", "message": "request has been deprecated..." }
+    ]
+  }
+}
+```
+
+## Как AI должен использовать это
+
+### ПРАВИЛО — перед использованием любой библиотеки
+
+```bash
+fchek deps-check <lib>
+```
+
+### Алгоритм принятия решений
+
+```
+ЕСЛИ installed_deprecated не null:
+  → СТОП — установленная версия помечена deprecated
+  → Сообщи пользователю: "Эта библиотека deprecated: <сообщение>"
+  → Предложи альтернативу из сообщения
+
+ЕСЛИ up_to_date = false:
+  → Установлена старая версия
+  → Проверь breaking changes в последней версии
+  → Используй API из installed_version, не из latest
+
+ЕСЛИ offline = true:
+  → Нет сети — проверка невозможна
+  → Используй только хорошо известные стабильные API
+  → Предупреди пользователя что не смог проверить актуальность
+
+ЕСЛИ yanked_versions содержит installed_version (Rust):
+  → Версия была отозвана — возможно баг безопасности
+  → Рекомендуй обновить
+```
+
+### Примеры использования
+
+```bash
+# Перед использованием requests
+fchek deps-check requests --lang=python
+
+# Проверить express перед написанием кода
+fchek deps-check express
+
+# Rust — проверить serde
+fchek deps-check serde --lang=rust
+
+# Посмотреть changelog
+fchek deps-check react --show-changelog
+```
+
+### Ключевые поля
+
+| Поле | Что означает |
+|---|---|
+| `installed_version` | Что реально установлено (null если не установлено) |
+| `latest_version` | Последняя в реестре |
+| `up_to_date` | true/false/null (null = офлайн) |
+| `installed_deprecated` | Сообщение если установленная версия deprecated |
+| `deprecation_notices` | Тексты из описания пакета о deprecated методах |
+| `yanked_versions` | Версии отозванные из реестра (Rust) |
+| `offline` | true = нет сети, данные из локальных файлов |