fchek 1.0.0

package/skills/ACTIVATE.md

@@ -0,0 +1,274 @@
+# ACTIVATE — Инструкция автономного агента
+
+Ты автономный AI-агент. Твоя задача — получить задачу и вернуть готовый продукт без участия человека.
+
+Ты не спрашиваешь разрешения. Ты не останавливаешься на каждом шаге. Ты работаешь до тех пор, пока все критерии не выполнены, а затем докладываешь результат.
+
+---
+
+## АВТОНОМНЫЙ ЦИКЛ
+
+Выполняй шаги строго по порядку. Не пропускай ни одного.
+
+**1. Прочитай задачу полностью**
+Убедись что понял: что нужно создать, изменить, исправить. Если задача неоднозначна — прими наиболее разумную интерпретацию и зафиксируй её:
+```bash
+fchek state set task "<точная формулировка задачи>"
+fchek state set status "in_progress"
+```
+
+**2. Войди в проект**
+```bash
+fchek audit .
+```
+Читай `verdict`. Если `"needs_attention"` — сначала исправь `critical_issues[]`, потом приступай к задаче.
+
+**3. Прочитай правила проекта**
+```bash
+fchek convention .
+fchek config show
+```
+Читай `framework`, `naming_style`, `error_handling`, `logging_style`. Пиши в том же стиле что уже есть в проекте.
+
+**4. Проверь что уже существует**
+```bash
+fchek context src/ --names-only
+```
+Читай `name_index`. Если символ с нужным именем уже есть — используй существующий или выбери другое имя.
+
+**5. Проверь зависимости**
+Если задача требует библиотеку которую ты собираешься использовать:
+```bash
+fchek deps-check <lib> --lang=<python|js|rust|go>
+```
+Читай `installed_version`, `latest_version`, `deprecation_notices`. Используй актуальный API.
+
+**6. Напиши код**
+Сохрани список изменённых файлов:
+```bash
+fchek state set files "src/auth.py tests/test_auth.py"
+```
+
+**7. Запусти и проверь**
+```bash
+fchek run <main_file>
+```
+Получи `exit_code: 0` и `success: true`. Если нет — исправь и запусти снова. Не переходи к следующему шагу пока не получишь `exit_code: 0`.
+
+**8. Прогони тесты**
+```bash
+fchek test .
+```
+Получи `verdict: "all_passed"`. Если `failures_found` — читай `failures[].reason`, исправь, запусти снова.
+
+**9. Проверь безопасность и стиль**
+```bash
+fchek secrets .
+fchek lint .
+```
+Получи `verdict: "clean"` от secrets. Получи `issues_count: 0` от lint (или примени `fchek lint . --fix` если `auto_fix` доступен).
+
+**10. Зафиксируй и доложи**
+```bash
+fchek git stage <files>
+fchek git commit "feat: <описание изменения>"
+fchek state set status "done"
+```
+Доложи результат: что сделано, какие файлы изменены, вывод `fchek run`, вывод `fchek test`.
+
+---
+
+## КРИТЕРИИ «ЗАДАЧА ВЫПОЛНЕНА»
+
+Задача выполнена только если ВСЕ пункты чеклиста выполнены:
+
+- [ ] **Сборка/запуск:**
+  ```bash
+  fchek run <main_file>
+  # Ожидаемый результат:
+  # {"status":"ok","data":{"exit_code":0,"success":true,"stdout":"...","stderr":""}}
+  ```
+
+- [ ] **Тесты:**
+  ```bash
+  fchek test .
+  # Ожидаемый результат:
+  # {"status":"ok","data":{"verdict":"all_passed","passed":N,"failed":0}}
+  ```
+
+- [ ] **Секреты:**
+  ```bash
+  fchek secrets .
+  # Ожидаемый результат:
+  # {"status":"ok","data":{"verdict":"clean","total_findings":0}}
+  ```
+
+- [ ] **Линт:**
+  ```bash
+  fchek lint .
+  # Ожидаемый результат:
+  # {"status":"ok","data":{"issues_count":0}}
+  ```
+
+- [ ] **Коммит:**
+  ```bash
+  fchek git commit "feat: ..."
+  # Ожидаемый результат:
+  # {"status":"ok","data":{"committed":true,"message":"feat: ..."}}
+  ```
+
+Если хоть один пункт не выполнен — задача не готова. Возвращайся к исправлению.
+
+---
+
+## КАК ОБРАБАТЫВАТЬ ОШИБКИ
+
+### `exit_code ≠ 0` (код не запускается)
+```
+1. Читай data.stderr — там точная причина
+2. Найди строку и файл из traceback
+3. Исправь конкретную ошибку (не переписывай всё)
+4. Запусти: fchek run <file>
+5. Повторяй пока exit_code = 0
+```
+
+### `verdict: "failures_found"` (тесты падают)
+```
+1. Читай data.failures[].test — имя теста
+2. Читай data.failures[].reason — причина падения
+3. Используй: fchek goto <file:line> — найди тест и код
+4. Реши: баг в коде или неправильный тест?
+5. Исправь, запусти: fchek test .
+6. Повторяй пока verdict = "all_passed"
+```
+
+### `verdict: "critical"` или `"issues_found"` (секреты в коде)
+```
+1. Читай findings[].file и findings[].line
+2. СТОП — не коммить и не показывай этот код
+3. Замени захардкоженное значение на переменную окружения
+   Python:  os.environ.get("KEY_NAME")
+   JS:      process.env.KEY_NAME
+   Rust:    std::env::var("KEY_NAME").expect("KEY_NAME not set")
+   C#:      Environment.GetEnvironmentVariable("KEY_NAME")
+4. Запусти: fchek secrets .
+5. Повторяй пока verdict = "clean"
+```
+Подробнее: **[security.md](./security.md)**
+
+### `issues_count > 0` (lint ошибки)
+```
+1. Попробуй автофикс: fchek lint . --fix
+2. Читай data.remaining_issues[] — что осталось
+3. Исправь вручную только severity: "error"
+4. severity: "warning" — исправь если быстро, иначе пропусти
+5. Запусти: fchek lint . --no-fix
+6. Повторяй пока issues_count = 0 (или ≤ config.lint_threshold)
+```
+
+### `compiled: false` (ошибка компиляции — C/C++/Rust/C#)
+```
+1. Читай data.stderr — там сообщение компилятора с номером строки
+2. Перейди к строке: fchek goto <file:line>
+3. Исправь синтаксическую или типовую ошибку
+4. Запусти: fchek run <file>
+5. Повторяй пока compiled = true и exit_code = 0
+```
+
+### `timed_out: true` (бесконечный цикл)
+```
+1. Ищи: while True без break, бесконечную рекурсию, deadlock
+2. Проверь условия выхода из циклов
+3. Для многопоточного кода: fchek race <file> --tsan
+4. Исправь, запусти с уменьшенным timeout: fchek run <file> --timeout=5000
+```
+
+### `"Runtime not found"` (рантайм не установлен)
+```
+1. Запусти: fchek doctor
+2. Читай data.tools[] — что отсутствует
+3. Установи по инструкции из fchek doctor
+4. Повторяй: fchek run <file>
+```
+
+### Блокер которого не можешь решить
+```
+1. Зафиксируй: fchek state set blocker "<описание проблемы>"
+2. Зафиксируй: fchek state set next_step "<что нужно сделать>"
+3. Доложи пользователю: что сделано, что заблокировано, что нужно
+```
+
+---
+
+## ЗАПРЕЩЕНО
+
+Это список действий которые нельзя делать никогда, при любых условиях:
+
+- **ЗАПРЕЩЕНО** говорить «готово», «работает», «исправил» без показа вывода `fchek run` с `exit_code: 0`
+- **ЗАПРЕЩЕНО** говорить «тесты проходят» без показа вывода `fchek test` с `verdict: "all_passed"`
+- **ЗАПРЕЩЕНО** создавать символ (функцию, класс, переменную) без предварительной проверки `fchek context`
+- **ЗАПРЕЩЕНО** использовать библиотеку без предварительной проверки `fchek deps-check`
+- **ЗАПРЕЩЕНО** коммитить код с секретами — обязательно `verdict: "clean"` перед коммитом
+- **ЗАПРЕЩЕНО** коммитить код с падающими тестами — обязательно `verdict: "all_passed"` перед коммитом
+- **ЗАПРЕЩЕНО** делать `git push` — это решение принимает только человек
+- **ЗАПРЕЩЕНО** удалять файлы без явного указания в задаче
+- **ЗАПРЕЩЕНО** изменять `.env` файлы и конфиги с секретами
+- **ЗАПРЕЩЕНО** писать SQL через f-strings / конкатенацию строк — только параметризованные запросы
+- **ЗАПРЕЩЕНО** логировать токены, пароли, ключи API
+
+---
+
+## Навигация по навыкам
+
+| Ситуация | Файл |
+|---|---|
+| Полный цикл автономной работы | **[agent.md](./agent.md)** |
+| Жёсткие правила (что можно, что нельзя) | **[rules.md](./rules.md)** |
+| Безопасность, секреты, SQL injection | **[security.md](./security.md)** |
+| C# / .NET специфика | **[csharp.md](./csharp.md)** |
+| Windows / WPF / UI проверка | **[windows.md](./windows.md)** |
+| Обзор всех команд | **[README.md](./README.md)** |
+| State vs REPL (память) | **[state.md](./state.md)** |
+
+
+---
+
+## WORKFLOW: Windows / WPF
+
+Для любого Windows GUI приложения (WPF, WinForms, MAUI):
+
+```bash
+# 1. Понять проект
+fchek convention .        # framework: WPF? → читай windows.md
+fchek context src/
+
+# 2. Проверить/убить старый экземпляр
+fchek process exists <AppName>
+fchek process kill <AppName>     # если exists: true
+
+# 3. Собрать
+fchek run src/App.cs             # dotnet build
+
+# 4. Запустить и дождаться окна
+fchek launch bin/Debug/net8.0-windows/App.exe --title=<AppName> --wait=8000
+# → window_appeared: true → хорошо
+# → window_appeared: false → fchek winlog --level=Error --since=2
+
+# 5. Проверить UI
+fchek screenshot --window=<AppName>
+# Прочитай изображение → правильно ли выглядит интерфейс?
+
+# 6. Проверить логи
+fchek winlog --source=Application --filter=<AppName> --level=Error --since=5
+
+# 7. Проверить реестр (если нужно)
+fchek registry get HKCU\Software\<AppName>
+```
+
+**ОБЯЗАТЕЛЬНО для WPF:**
+- `window_appeared: true` перед тем как говорить "запустилось"
+- `fchek screenshot` перед тем как говорить "UI выглядит правильно"
+- `fchek winlog` если `window_appeared: false`
+
+Подробно → **[windows.md](./windows.md)**
+

package/skills/README.md

@@ -0,0 +1,163 @@
+# fchek skills — Справочник агента
+
+Команды в порядке использования в автономном цикле.
+Файлы навыков — это инструкции агенту, не документация.
+
+---
+
+## Таблица: фаза → команда → что проверяй → файл навыка
+
+| Фаза | Команда | Что проверяй в выводе | Файл навыка |
+|---|---|---|---|
+| **ПОНЯЛ: проект** | `fchek audit .` | `verdict: "healthy"`, `critical_issues: []` | — |
+| **ПОНЯЛ: конвенции** | `fchek convention .` | `naming_style`, `error_handling`, `logging_style[0]` | [convention.md](./convention.md) |
+| **ПОНЯЛ: конфиг** | `fchek config show` | `lang`, `test_command`, `coverage_threshold` | — |
+| **ПОНЯЛ: git** | `fchek git status` | `branch`, `is_clean`, `unstaged[]` | — |
+| **СПЛАНИРОВАЛ: символы** | `fchek context <dir>` | `name_index` — нет дублей | [context.md](./context.md) |
+| **СПЛАНИРОВАЛ: зависимости** | `fchek deps-check <lib> --lang=X` | `installed_deprecated`, `deprecation_notices` | [deps-check.md](./deps-check.md) |
+| **ПРОВЕРИЛ: запуск** | `fchek run <file>` | `exit_code: 0`, `success: true` | [run.md](./run.md) |
+| **ПРОВЕРИЛ: тесты** | `fchek test .` | `verdict: "all_passed"`, `failed: 0` | — |
+| **ПРОВЕРИЛ: секреты** | `fchek secrets .` | `verdict: "clean"`, `total_findings: 0` | [secrets.md](./secrets.md) |
+| **ПРОВЕРИЛ: уязвимости** | `fchek vuln [dir]` | `typosquatting_warnings: [], vulnerabilities: []` | [vuln.md](./vuln.md) |
+| **ПРОВЕРИЛ: линт** | `fchek lint .` | `issues_count: 0` | [lint.md](./lint.md) |
+| **ПРОВЕРИЛ: покрытие** | `fchek coverage .` | `line_rate ≥ threshold` | [coverage.md](./coverage.md) |
+| **ПРОВЕРИЛ: гонки** | `fchek race <file>` | `verdict: "clean"` | [race.md](./race.md) |
+| **ПРОВЕРИЛ: DOM** | `fchek dom <src> <sel>` | `count > 0`, `matches[]` | [dom.md](./dom.md) |
+| **ЗАФИКСИРОВАЛ** | `fchek git stage <files>` | `staged[]` содержит файлы | — |
+| **ЗАФИКСИРОВАЛ** | `fchek git commit "type: msg"` | `committed: true` | — |
+| **АНАЛИЗ: производительность** | `fchek profile <file>` | `hot_functions[]`, `total_time` | [profile.md](./profile.md) |
+| **АНАЛИЗ: сеть/порты** | `fchek port <port>` | `in_use: true/false`, `connections[]` | [port.md](./port.md) |
+| **АНАЛИЗ: API/сеть** | `fchek api <url>` | `status_code: 200`, `time_ms` | [api.md](./api.md) |
+| **АНАЛИЗ: БД** | `fchek db schema/query <db>` | `tables[]`, `rows[]` | [db.md](./db.md) |
+| **АНАЛИЗ: контейнеры** | `fchek docker list/logs` | `containers[]`, `logs` | [docker.md](./docker.md) |
+| **АНАЛИЗ: зависимости** | `fchek deps .` | `dead_code[]`, `outdated[]` | [deps.md](./deps.md) |
+| **АНАЛИЗ: бенчмарк** | `fchek bench . --before=A --after=B` | `delta_ms`, `regression: false` | [bench.md](./bench.md) |
+| **АНАЛИЗ: фаззинг** | `fchek fuzz <file>` | `crashes: 0` | [fuzz.md](./fuzz.md) |
+| **НАВИГАЦИЯ** | `fchek goto <file:line>` | `definition`, `references[]` | [goto.md](./goto.md) |
+| **ПАМЯТЬ: диск** | `fchek state set/get/list` | `key: value` | [state.md](./state.md) |
+| **ПАМЯТЬ: RAM** | `fchek repl` | интерактивный режим | [repl.md](./repl.md) |
+| **ОКРУЖЕНИЕ** | `fchek doctor` | `tools[].status: "ok"` | — |
+
+---
+
+## Матрица языков — поддержка команд
+
+| Команда | Python | JS/TS | Rust | C/C++ | C# | Go |
+|---|---|---|---|---|---|---|
+| `run` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `test` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `secrets` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `lint` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `coverage` | ✓ | ✓ | ✓ | — | ✓ | ✓ |
+| `context` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `convention` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| `deps-check` | ✓ | ✓ | ✓ | — | ✓ | ✓ |
+| `deps` | ✓ | ✓ | ✓ | — | ✓ | ✓ |
+| `race` | — | — | ✓ | ✓ | — | ✓ |
+| `fuzz` | ✓ | — | ✓ | ✓ | — | ✓ |
+| `profile` | ✓ | ✓ | ✓ | ✓ | — | ✓ |
+| `bench` | ✓ | ✓ | ✓ | ✓ | — | ✓ |
+| `goto` | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+
+**C# ограничение:** `race`, `fuzz`, `profile`, `bench` не поддерживаются. Используй dotnet-trace / VS Profiler.
+Подробнее: [csharp.md](./csharp.md)
+
+---
+
+## Формат JSON вывода
+
+Все команды fchek возвращают единообразный JSON:
+
+```json
+{
+  "status": "ok",
+  "command": "<имя команды>",
+  "data": {
+    "<специфичные поля команды>"
+  }
+}
+```
+
+При ошибке:
+```json
+{
+  "status": "error",
+  "command": "<имя команды>",
+  "error": "<описание ошибки>",
+  "data": null
+}
+```
+
+### Ключевые поля по командам:
+
+```
+fchek run       → data.exit_code, data.success, data.stdout, data.stderr
+fchek test      → data.verdict, data.passed, data.failed, data.failures[]
+fchek secrets   → data.verdict, data.total_findings, data.findings[]
+fchek lint      → data.issues_count, data.fixed, data.remaining_issues[]
+fchek coverage  → data.line_rate, data.branches_covered, data.uncovered_lines[]
+fchek context   → data.name_index, data.duplicates, data.symbols[]
+fchek convention→ data.conventions[].framework, .naming_style, .error_handling
+fchek deps-check→ data.installed_version, data.latest_version, data.deprecation_notices[]
+fchek race      → data.verdict, data.issues[], data.summary
+fchek profile   → data.hot_functions[], data.total_time_ms
+fchek bench     → data.delta_ms, data.regression, data.before, data.after
+fchek audit     → data.verdict, data.critical_issues[], data.next_actions[]
+fchek git status→ data.branch, data.staged[], data.unstaged[], data.is_clean
+fchek state list→ data.state{task, status, files, next_step, blocker}
+```
+
+---
+
+## Ключевые файлы инструкций
+
+| Файл | Когда читать |
+|---|---|
+| **ACTIVATE.md** | Старт. Автономный цикл, критерии готовности, запрещённые действия |
+| **agent.md** | Детали каждой фазы, примеры диалогов, петля исправления |
+| **rules.md** | Жёсткие правила с примерами запрещённого и обязательного |
+| **security.md** | Секреты, SQL injection, что не логировать, примеры по языкам |
+| **state.md** | Что хранить на диске vs RAM, сценарий автономной сессии |
+| **csharp.md** | C# / .NET специфика, workflow, ограничения fchek |
+| **run.md** | Синтаксис run, поддерживаемые языки, интерпретация вывода |
+| **secrets.md** | Подробно про fchek secrets, паттерны, инструменты |
+| **context.md** | fchek context — навигация по символам |
+| **convention.md** | fchek convention — стиль проекта |
+| **lint.md** | fchek lint — автоматическое исправление |
+| **coverage.md** | fchek coverage — покрытие тестами |
+| **deps-check.md** | fchek deps-check — проверка актуальности зависимостей |
+| **race.md** | fchek race — гонки данных, memory safety |
+| **fuzz.md** | fchek fuzz — fuzzing, поиск крашей |
+| **profile.md** | fchek profile — горячие функции |
+| **bench.md** | fchek bench — сравнение производительности |
+| **goto.md** | fchek goto — LSP навигация |
+| **repl.md** | fchek repl — интерактивная сессия |
+| **port.md** | fchek port — сетевые порты |
+| **api.md** | fchek api — HTTP/API запросы |
+| **db.md** | fchek db — SQLite схемы и запросы |
+| **docker.md** | fchek docker — Docker list/logs |
+| **vuln.md** | fchek vuln — уязвимости и тайпосквоттинг |
+| **dom.md** | fchek dom — Web парсинг HTML |
+
+---
+
+## Быстрый старт (минимальный цикл)
+
+```bash
+# Войти в проект
+fchek audit .
+fchek convention .
+fchek context src/ --names-only
+
+# [написать код]
+
+# Обязательные проверки
+fchek run <main_file>
+fchek test .
+fchek secrets .
+fchek lint .
+
+# Зафиксировать
+fchek git stage <files>
+fchek git commit "feat: <описание>"
+```