@kirrosh/apitool 0.4.3

package/docs/archive/M5-M7-storage-junit.md

@@ -0,0 +1,300 @@
+> **Исторический snapshot** на момент реализации M5+JUnit. Актуальная документация — [APITOOL.md](../../APITOOL.md)
+
+# M5: Storage (SQLite) + JUnit Reporter
+
+Автоматическое сохранение истории прогонов в SQLite и JUnit XML для CI-систем.
+
+## Быстрый старт
+
+```bash
+# Запуск с сохранением в БД (по умолчанию)
+bun src/cli/index.ts run examples/
+
+# JUnit XML для CI
+bun src/cli/index.ts run tests/ --report junit > results.xml
+
+# Без сохранения в БД
+bun src/cli/index.ts run tests/ --no-db
+
+# Своя БД
+bun src/cli/index.ts run tests/ --db /path/to/my.db
+```
+
+---
+
+## JUnit Reporter
+
+### Использование
+
+```bash
+bun src/cli/index.ts run tests/ --report junit
+bun src/cli/index.ts run tests/ --report junit > results.xml
+```
+
+### Формат вывода
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<testsuites tests="5" failures="1" errors="0" time="2.340">
+  <testsuite name="Users CRUD" tests="5" failures="1" errors="0" skipped="0" time="2.340">
+    <testcase name="Create user" time="0.450"/>
+    <testcase name="Get user" time="0.120"/>
+    <testcase name="Update user" time="0.310">
+      <failure message="equals 200: expected 200, got 500">equals 200: expected 200, got 500</failure>
+    </testcase>
+    <testcase name="Verify deleted" time="0.000">
+      <skipped/>
+    </testcase>
+    <testcase name="Broken endpoint" time="0.050">
+      <error message="Connection refused">Connection refused</error>
+    </testcase>
+  </testsuite>
+</testsuites>
+```
+
+### Маппинг статусов
+
+| Статус шага | XML-элемент |
+|-------------|-------------|
+| `pass` | `<testcase .../>`  (без дочерних элементов) |
+| `skip` | `<testcase ...><skipped/></testcase>` |
+| `fail` | `<testcase ...><failure message="...">...</failure></testcase>` |
+| `error` | `<testcase ...><error message="...">...</error></testcase>` |
+
+**Атрибут `time`** — в секундах с тремя знаками после запятой: `(ms / 1000).toFixed(3)`.
+
+**XML-экранирование** применяется ко всем строковым значениям: `& < > " '`.
+
+### Программное использование
+
+```typescript
+import { junitReporter } from "./src/core/reporter/junit.ts";
+import type { TestRunResult } from "./src/core/runner/types.ts";
+
+const results: TestRunResult[] = /* ... */;
+junitReporter.report(results);  // пишет XML в stdout
+```
+
+---
+
+## Storage (SQLite)
+
+### Поведение по умолчанию
+
+При каждом `apitool run` создаётся или обновляется файл `apitool.db` в текущей директории. Файл создаётся автоматически при первом запуске.
+
+```bash
+apitool run tests/            # сохраняет в ./apitool.db
+apitool run tests/ --no-db    # пропустить сохранение
+apitool run tests/ --db ci.db # сохранить в ci.db
+```
+
+Флаг `--db` принимает абсолютный или относительный путь.
+
+### Схема БД
+
+```sql
+CREATE TABLE runs (
+  id          INTEGER PRIMARY KEY AUTOINCREMENT,
+  started_at  TEXT NOT NULL,    -- ISO 8601
+  finished_at TEXT,
+  total       INTEGER NOT NULL DEFAULT 0,
+  passed      INTEGER NOT NULL DEFAULT 0,
+  failed      INTEGER NOT NULL DEFAULT 0,
+  skipped     INTEGER NOT NULL DEFAULT 0,
+  trigger     TEXT DEFAULT 'manual',
+  commit_sha  TEXT,
+  branch      TEXT,
+  environment TEXT,
+  duration_ms INTEGER
+);
+
+CREATE TABLE results (
+  id              INTEGER PRIMARY KEY AUTOINCREMENT,
+  run_id          INTEGER NOT NULL REFERENCES runs(id),
+  suite_name      TEXT NOT NULL,
+  test_name       TEXT NOT NULL,
+  status          TEXT NOT NULL,  -- pass | fail | skip | error
+  duration_ms     INTEGER NOT NULL,
+  request_method  TEXT,
+  request_url     TEXT,
+  request_body    TEXT,
+  response_status INTEGER,
+  response_body   TEXT,           -- хранится только при fail/error
+  error_message   TEXT,
+  assertions      TEXT            -- JSON: AssertionResult[]
+);
+
+CREATE TABLE environments (
+  id        INTEGER PRIMARY KEY AUTOINCREMENT,
+  name      TEXT NOT NULL UNIQUE,
+  variables TEXT NOT NULL         -- JSON: Record<string, string>
+);
+```
+
+**Примечание:** `response_body` сохраняется только для шагов со статусом `fail` или `error`, чтобы экономить место.
+
+### Миграции
+
+Версия схемы хранится в `PRAGMA user_version`. При каждом открытии БД применяются только недостающие миграции в транзакции.
+
+### Настройки производительности
+
+При открытии БД автоматически устанавливаются:
+- `PRAGMA journal_mode = WAL` — concurrent reads без блокировки
+- `PRAGMA foreign_keys = ON` — проверка ссылочной целостности
+
+### Программное использование
+
+```typescript
+import { getDb, closeDb } from "./src/db/schema.ts";
+import {
+  createRun, finalizeRun, saveResults,
+  getRunById, listRuns, deleteRun,
+  upsertEnvironment, getEnvironment, listEnvironments,
+} from "./src/db/queries.ts";
+
+// Открыть БД (синглтон)
+const db = getDb();           // apitool.db в cwd
+const db2 = getDb("my.db");   // конкретный файл
+
+// Сохранить прогон
+const runId = createRun({ started_at: new Date().toISOString(), environment: "staging" });
+// ... выполнить тесты ...
+finalizeRun(runId, results);
+saveResults(runId, results);
+
+// Чтение истории
+const runs = listRuns(10, 0);        // последние 10 прогонов
+const run = getRunById(1);
+const steps = getResultsByRunId(1);  // шаги с десериализованными assertions
+
+// Управление окружениями
+upsertEnvironment("staging", { BASE_URL: "https://staging.example.com" });
+const vars = getEnvironment("staging");
+const names = listEnvironments();
+
+// В тестах — закрыть синглтон
+closeDb();
+```
+
+### API queries.ts
+
+| Функция | Описание |
+|---------|----------|
+| `createRun(opts)` → `number` | Создать запись run, вернуть id |
+| `finalizeRun(runId, results[])` | Обновить totals и finished_at |
+| `saveResults(runId, results[])` | Bulk-insert шагов в транзакции |
+| `getRunById(id)` → `RunRecord \| null` | Запись run по id |
+| `getResultsByRunId(id)` → `StoredStepResult[]` | Шаги run с assertions из JSON |
+| `listRuns(limit?, offset?)` → `RunSummary[]` | Список прогонов по дате DESC |
+| `deleteRun(id)` → `boolean` | Удалить run и его результаты |
+| `upsertEnvironment(name, vars)` | Создать или обновить окружение |
+| `getEnvironment(name)` → `Record<string, string> \| null` | Переменные окружения |
+| `listEnvironments()` → `string[]` | Имена всех окружений |
+
+---
+
+## Новые флаги CLI
+
+### `run` — обновлённая сигнатура
+
+```
+apitool run <path> [options]
+
+  --report <format>    console | json | junit  (default: console)
+  --no-db              Не создавать/обновлять apitool.db
+  --db <path>          Путь к файлу БД  (default: apitool.db в cwd)
+  --env <name>         Файл окружения .env.<name>.yaml
+  --timeout <ms>       Таймаут запроса
+  --bail               Остановиться после первого упавшего suite
+  --auth-token <token> Auth-токен, доступен как {{auth_token}} переменная
+```
+
+### Примеры
+
+```bash
+# Стандартный прогон: вывод в консоль + сохранение в apitool.db
+apitool run tests/
+
+# CI: JUnit XML + своя БД
+apitool run tests/ --report junit --db ci/history.db > junit.xml
+
+# Dry-run без БД
+apitool run tests/ --no-db
+
+# Staging-окружение
+apitool run tests/ --env staging --db runs/staging.db
+
+# Только JUnit, без записи в БД
+apitool run tests/ --report junit --no-db > results.xml
+
+# CI с внешним токеном
+apitool run tests/ --auth-token "$CI_AUTH_TOKEN" --report junit > results.xml
+```
+
+---
+
+## Архитектура
+
+### Pipeline команды `run` (обновлённый)
+
+```
+parse(path)
+  → loadEnvironment(env, dir)
+  → [if --auth-token] env.auth_token = token
+  → --timeout override
+  → runSuites() / runSuites() + bail
+  → reporter.report(results)           # console | json | junit
+  → [if !--no-db] getDb(dbPath)
+                  createRun(opts)
+                  finalizeRun(runId, results)
+                  saveResults(runId, results)
+  → exit code (0 | 1 | 2)
+```
+
+Сохранение в БД — **non-fatal**: при ошибке выводится предупреждение, exit code не меняется.
+
+### Файловая структура
+
+```
+src/
+├── db/
+│   ├── schema.ts    # getDb(), closeDb(), миграции
+│   └── queries.ts   # CRUD: runs, results, environments
+└── core/reporter/
+    ├── junit.ts     # JUnit XML reporter
+    ├── types.ts     # ReporterName: "console"|"json"|"junit"
+    └── index.ts     # getReporter() factory
+```
+
+### Reporter factory
+
+```typescript
+import { getReporter } from "./src/core/reporter/index.ts";
+
+const reporter = getReporter("junit");   // "console" | "json" | "junit"
+reporter.report(results);
+```
+
+---
+
+## Тесты
+
+```bash
+bun test tests/reporter/junit.test.ts  # JUnit reporter (22 tests)
+bun test tests/db/schema.test.ts       # SQLite schema (10 tests)
+bun test tests/db/queries.test.ts      # DB queries (20 tests)
+bun test tests/cli/commands.test.ts    # CLI commands (16 tests)
+
+bun test tests/                        # все unit-тесты
+```
+
+### Покрытие
+
+| Файл | Тесты |
+|------|-------|
+| `reporter/junit.ts` | XML-структура, time-форматирование, XML-экранирование, все 4 статуса |
+| `db/schema.ts` | Создание файла, синглтон, таблицы, индексы, WAL, FK, версия, идемпотентность |
+| `db/queries.ts` | createRun, finalizeRun, saveResults, getResultsBy RunId, listRuns, deleteRun, environments |
+| `cli/commands/run.ts` | `--no-db` пропускает БД, `--db` использует указанный путь, junit reporter в pipeline, `--auth-token` парсинг и инъекция |

package/docs/archive/M6-webui.md

@@ -0,0 +1,339 @@
+> **Исторический snapshot** на момент реализации M6. Актуальная документация — [APITOOL.md](../../APITOOL.md)
+
+# M6: WebUI (Hono + HTMX)
+
+HTML-дашборд для просмотра истории прогонов, метрик и исследования API.
+
+## Быстрый старт
+
+```bash
+# Установить зависимость (уже добавлена)
+bun add hono
+
+# Запустить с OpenAPI спекой (URL или файл)
+bun src/cli/index.ts serve --port 8080 --openapi https://petstore3.swagger.io/api/v3/openapi.json
+
+# Запустить только с дашбордом (без Explorer)
+bun src/cli/index.ts serve --port 8080
+
+# Своя БД
+bun src/cli/index.ts serve --port 8080 --db history.db
+```
+
+Открыть http://localhost:8080 в браузере.
+
+---
+
+## CLI: `apitool serve`
+
+```
+apitool serve [options]
+
+  --port <port>      Порт сервера (default: 8080)
+  --host <host>      Хост сервера (default: 0.0.0.0)
+  --openapi <spec>   Путь к OpenAPI спеке или URL для Explorer
+  --db <path>        Путь к SQLite БД (default: apitool.db)
+```
+
+---
+
+## Страницы
+
+| Route | Описание |
+|-------|----------|
+| `GET /` | Dashboard: карточки метрик, SVG trend chart, коллекции, последние прогоны, медленные/flaky тесты |
+| `GET /metrics` | HTML-фрагмент метрик (для HTMX auto-refresh) |
+| `GET /runs` | Список прогонов с фильтрацией (статус, environment, дата, поиск) и пагинацией (20 на страницу) |
+| `GET /runs/:id` | Детали прогона: шаги по suite, expand failed, кнопки Export JUnit XML / JSON |
+| `GET /explorer` | Дерево API из OpenAPI спеки, multi-auth panel, "Try it" формы |
+| `GET /static/style.css` | CSS стили |
+| `POST /api/run` | Запуск тестов из WebUI |
+| `POST /api/try` | Единичный HTTP-запрос из Explorer (с auth injection) |
+| `POST /api/authorize` | Proxy login для Bearer auth |
+| `GET /api/export/:runId/junit` | Скачать JUnit XML отчёт (Content-Disposition: attachment) |
+| `GET /api/export/:runId/json` | Скачать JSON отчёт (Content-Disposition: attachment) |
+
+---
+
+## Dashboard (`GET /`)
+
+Карточки:
+- **Total Runs** — количество завершённых прогонов
+- **Total Tests** — сумма всех тестов по всем прогонам
+- **Pass Rate** — `SUM(passed) * 100 / SUM(total)` (%)
+- **Avg Duration** — среднее время прогона
+
+**Pass Rate Trend Chart** (между карточками и коллекциями):
+- Inline SVG (viewBox 700x200, width=100%), area fill + polyline
+- Grid lines at 0/25/50/75/100%, Y-axis labels
+- Circle dots с `<title>` tooltips (run ID, pass rate, date)
+- X-axis: 3 date labels (first, middle, last)
+- Использует CSS variables — dark mode автоматически
+- Guard: < 2 data points → "Not enough data" текст
+- Shared модуль `src/web/views/trend-chart.ts` — переиспользуется на dashboard и collection page
+
+**Collection page** (`/collections/:id`) также показывает собственный тренд-график (только прогоны этой коллекции) между метриками и секцией Test Suites.
+
+Таблицы:
+- **Recent Runs** (последние 5) — ID, дата, total/pass/fail/skip, duration, badge
+- **Slowest Tests** (top 5) — suite, test, средняя длительность
+- **Flaky Tests** (top 5) — тесты с разными статусами в последних 20 прогонах
+
+Auto-refresh: `hx-trigger="every 10s"` на блоке метрик.
+
+### SQL-запросы (добавлены в `src/db/queries.ts`)
+
+| Функция | Описание |
+|---------|----------|
+| `getDashboardStats()` → `DashboardStats` | Агрегаты: totalRuns, totalTests, overallPassRate, avgDuration |
+| `getPassRateTrend(limit)` → `PassRateTrendPoint[]` | Pass rate по последним N прогонам (глобальный) |
+| `getCollectionPassRateTrend(collectionId, limit)` → `PassRateTrendPoint[]` | Pass rate по прогонам конкретной коллекции |
+| `getSlowestTests(limit)` → `SlowestTest[]` | AVG(duration_ms) GROUP BY suite+test, ORDER BY DESC |
+| `getFlakyTests(runsBack, limit)` → `FlakyTest[]` | Тесты с COUNT(DISTINCT status) > 1 |
+| `countRuns(filters?)` → `number` | Количество записей в runs (с фильтрами) |
+| `getDistinctEnvironments()` → `string[]` | Уникальные environment из runs |
+| `buildRunFilterSQL(filters)` → `{where, params}` | WHERE clause builder для RunFilters |
+
+---
+
+## Runs (`GET /runs`, `GET /runs/:id`)
+
+### Список прогонов
+
+**Filter bar** (HTMX form, `hx-push-url`):
+- Status: `<select>` — All / Has Failures / All Passed
+- Environment: `<select>` из `getDistinctEnvironments()`
+- Date from/to: `<input type="date">`
+- Test name: `<input type="text">` (LIKE search)
+- Кнопки: Filter, Clear
+
+Таблица с колонками: ID | Date | Total | Pass | Fail | Skip | Duration | Status badge.
+
+Пагинация: `?page=N`, 20 записей на страницу. Фильтры сохраняются в URL query params через `buildQueryString()`. HTMX `hx-get` + `hx-push-url` для SPA-навигации.
+
+DB-функции:
+- `RunFilters` interface: `{ status?, environment?, date_from?, date_to?, test_name? }`
+- `buildRunFilterSQL(filters)` — WHERE clause с parameterized placeholders
+- `listRuns(limit, offset, filters?)` — backward-compatible optional param
+- `countRuns(filters?)` — backward-compatible
+- `getDistinctEnvironments()` — `SELECT DISTINCT environment FROM runs`
+
+### Детали прогона
+
+- Шапка: ID, дата, environment, duration, totals (pass/fail/skip)
+- **Export buttons**: "Export JUnit XML" / "Export JSON" — plain `<a download>` links to `/api/export/:runId/...`
+- Шаги сгруппированы по suite
+- Каждый шаг: badge (✓/✗/○), имя, duration
+- Клик на failed/error шаг раскрывает панель с:
+  - Request method + URL
+  - Error message (если error)
+  - Список assertions (pass/fail с actual значениями)
+
+---
+
+## Explorer (`GET /explorer`)
+
+### Без спеки
+
+Если `--openapi` не указан — страница с сообщением и инструкцией.
+
+### С OpenAPI спекой
+
+- Спека загружается при старте сервера (файл или URL)
+- Эндпоинты сгруппированы по `tags[0]`
+- Каждый эндпоинт показывает: method badge (цветной), path, summary
+- Клик раскрывает панель:
+  - **Parameters** — таблица (name, in, required, type)
+  - **Request Body** — JSON-схема (если есть)
+  - **Responses** — таблица (status, description)
+  - **Try it** — форма для отправки запроса
+
+### Base URL из спеки
+
+Поле `servers` из OpenAPI спеки подставляется автоматически (как в Swagger UI):
+- 1 сервер → input с заполненным значением
+- Несколько серверов → dropdown для выбора
+- Нет серверов → пустое поле
+
+### Authorize Panel (multi-scheme)
+
+При наличии `securitySchemes` в OpenAPI спеке отображается панель авторизации с поддержкой нескольких схем одновременно.
+
+**Credential Store** — глобальный объект `window.__authCredentials`, хранящий активные авторизации по имени схемы. HTMX-хук `htmx:configRequest` автоматически инжектит все активные credentials в каждый `/api/try` запрос.
+
+**Поддерживаемые типы:**
+
+| Тип | UI | Поведение |
+|-----|-----|-----------|
+| `http/bearer` | Поле для прямого токена + login-proxy (если `loginPath`) | `Authorization: Bearer <token>` |
+| `http/basic` | Username + password | Клиентский `btoa(user:pass)` → `Authorization: Basic <encoded>` |
+| `apiKey` | Поле для значения, badge с расположением | Header или query param по спеке |
+| `oauth2`, `openIdConnect` | Имя + "Not yet supported" | — |
+
+**Per-scheme статус:** каждая схема показывает badge "Active" после применения. Глобальный счётчик показывает количество активных схем.
+
+**Функции:**
+- `applyBearerDirect(name)` — прямой токен
+- `doLoginProxy(name, loginPath)` — proxy через `/api/authorize`
+- `applyApiKey(name, location, keyName)` — header или query
+- `applyBasic(name)` — `btoa(user:pass)`
+
+### POST /api/authorize
+
+Proxy для Bearer auth через login endpoint.
+
+**Body (JSON):**
+```json
+{
+  "base_url": "http://localhost:3000",
+  "path": "/auth/login",
+  "username": "admin",
+  "password": "secret"
+}
+```
+
+**Поведение:**
+1. Отправляет POST `base_url + path` с `{username, password}`
+2. Ищет `token` или `access_token` в JSON-ответе
+3. Возвращает `{token}` или `{error}`
+
+### Try it (`POST /api/try`)
+
+Форма собирает:
+- Base URL (из servers или вручную)
+- Path parameters → подставляются в URL `{param}`
+- Query parameters → добавляются к URL
+- Header parameters → отправляются как заголовки
+- Auth credentials → инжектятся через HTMX-хук из credential store
+- Body (JSON) → отправляется как request body
+
+Ответ вставляется через HTMX: статус (цветной), заголовки (collapsible), тело (pretty JSON).
+
+---
+
+## API (`POST /api/run`, `POST /api/try`)
+
+### POST /api/run
+
+Запуск тестов из WebUI.
+
+**Body (JSON):**
+```json
+{
+  "path": "tests/",
+  "env": "staging"
+}
+```
+
+**Поведение:**
+1. `parse(path)` → `loadEnvironment()` → `runSuite()` для каждого suite
+2. Результаты сохраняются в БД (trigger: "webui")
+3. Возвращает `HX-Redirect: /runs/:id` для перенаправления
+
+### POST /api/try
+
+Единичный HTTP-запрос из Explorer.
+
+**Поддерживает два формата входа:**
+- `application/x-www-form-urlencoded` (от HTMX форм)
+- `application/json`
+
+**Возвращает HTML-фрагмент** (для вставки через HTMX):
+- Статус с цветом (2xx=зелёный, 4xx=оранжевый, 5xx=красный)
+- Headers (в `<details>`)
+- Body (pretty-printed JSON если возможно)
+
+---
+
+### Export (`GET /api/export/:runId/junit`, `GET /api/export/:runId/json`)
+
+Скачивание результатов прогона в формате JUnit XML или JSON.
+
+**Реализация:**
+- `reconstructResults(runId)` — helper в `api.ts`, пересобирает `TestRunResult[]` из `getRunById()` + `getResultsByRunId()`, группирует по `suite_name`, маппит `StoredStepResult` → `StepResult`
+- `generateJunitXml(results)` — извлечена из `junitReporter.report()` в `junit.ts` (CLI поведение не изменилось)
+- Response: `Content-Disposition: attachment; filename="run-N-*.ext"`, соответствующий Content-Type
+
+---
+
+## Архитектура
+
+### Файловая структура
+
+```
+src/web/
+├── server.ts          # Hono app, static serving, startServer()
+├── routes/
+│   ├── dashboard.ts   # GET /, GET /metrics
+│   ├── collections.ts # GET /collections/:id, POST/DELETE /api/collections
+│   ├── runs.ts        # GET /runs (с фильтрами), GET /runs/:id
+│   ├── explorer.ts    # GET /explorer
+│   └── api.ts         # POST /api/run, POST /api/try, GET /api/export
+├── views/
+│   ├── layout.ts      # HTML layout, escapeHtml()
+│   └── trend-chart.ts # Shared SVG trend chart component
+└── static/
+    └── style.css      # CSS (dark/light, responsive)
+```
+
+### Стилизация
+
+Один CSS файл без фреймворков:
+- CSS variables для цветов (pass/fail/skip/error)
+- `prefers-color-scheme: dark` для автоматической тёмной темы
+- Responsive через `max-width: 1100px`
+- Компоненты: cards, tables, badges, progress bar, forms
+
+### HTMX-паттерны
+
+- `hx-get` + `hx-target="main"` + `hx-push-url="true"` — SPA-навигация без перезагрузки
+- `hx-trigger="every 10s"` — авто-обновление метрик
+- `hx-post` + `hx-target="#response-N"` — отправка Try it формы
+- `HX-Request: true` header — сервер возвращает фрагмент вместо полной страницы
+
+### Программное использование
+
+```typescript
+import { createApp } from "./src/web/server.ts";
+import { startServer } from "./src/web/server.ts";
+
+// Для тестов — без поднятия сервера
+const app = createApp({ endpoints: [], specPath: null, servers: [], securitySchemes: [], loginPath: null });
+const response = await app.request("/");
+
+// Запуск сервера
+await startServer({ port: 8080, openapiSpec: "api.yaml" });
+```
+
+---
+
+## Тесты
+
+```bash
+bun test tests/web/routes.test.ts      # 11 тестов роутов
+bun test tests/web/explorer.test.ts    # 14 тестов Explorer
+bun test tests/db/queries.test.ts      # dashboard-метрики (8 тестов)
+
+bun test tests/web/ tests/db/          # все web + db тесты
+```
+
+### Покрытие
+
+| Файл | Тесты |
+|------|-------|
+| `web/routes.test.ts` | Dashboard 200, metrics fragment, runs list, run details, 404/400, static CSS, HTMX fragments, pagination |
+| `web/explorer.test.ts` | No-spec message, endpoint tree, tag grouping, parameters, request body, pre-filled server URL, HTMX fragment, bearer auth panel, API Key rendering, Basic auth rendering, multi-scheme, oauth2 unsupported, bearer without loginPath |
+| `db/queries.test.ts` | getDashboardStats (zeros, aggregates), getPassRateTrend, getSlowestTests, getFlakyTests, countRuns |
+
+Hono позволяет тестировать без поднятия HTTP-сервера: `app.request(path)` возвращает стандартный `Response`.
+
+---
+
+## Зависимости
+
+| Пакет | Версия | Назначение |
+|-------|--------|------------|
+| `hono` | 4.12.2 | HTTP-сервер, роутинг |
+| HTMX | 2.0.4 (CDN) | Интерактивность без JS-фреймворка |
+
+Нет сборщиков, бандлеров, node_modules для фронта. HTMX подключается через CDN `<script>`.