guard/CHANGELOG.md
loki5512344 280284667f
docs: per-task roadmap, architecture and changelog
- Split TODO into a thin status index plus docs/roadmap/ with one file per
  task (v0.4 reliability, v0.5 product, v0.6 research, icebox).
- Add docs/architecture.md (current processes, packet/data path, layers,
  storage, metrics) and docs/development.md (rules, gates, DoD).
- Add CHANGELOG.md reconstructed from history; move round details out of
  TODO.
- Align docs with the code: config defaults and missing [detect]/
  [protocol.http] sections, XDP metric names, ClickHouse table and TTL,
  Redis RDB restore, multiarch clang include, CLI binary name.
- Add scripts/check_docs_links.sh and run it in CI.
- release profile: thin LTO + one codegen unit. Binary 12.3 MB -> 9.7 MB,
  http parser bench 314 ns -> 278 ns; panic=abort stays off for
  catch_unwind in the Redis subscriber.
- Drop the unused JWT role claim; fix 'rampart doctor' hints in the CLI.
2026-11-16 14:51:50 +01:00

5.3 KiB
Raw Blame History

Changelog

Все значимые изменения проекта. Формат — Keep a Changelog, версии — Semantic Versioning.


[Unreleased]

Added

  • docs/architecture.md — текущее устройство системы (процессы, путь трафика, слои, хранилища, метрики).
  • docs/development.md — принципы, лимиты, гейты, Definition of Done.
  • docs/roadmap/ — по одному файлу на задачу; TODO.md стал тонким индексом.
  • CHANGELOG.md — этот файл.

Changed

  • [profile.release]: lto = "thin", codegen-units = 1. Релизный бинарь с protocol-http уменьшился с 12.3 МБ до 9.7 МБ (−21%); http_parser/evaluate в criterion — 314 нс → 278 нс (−12%), остальные бенчмарки в пределах шума.
  • CI: экшены обновлены до node24-версий, раннер закреплён на ubuntu-24.04.

Fixed

  • Docker edge image: в сборку добавлен benches/, без него Cargo не парсил манифест и образ не собирался (exit 101).
  • rampart-cli status подсказывал неверный бинарь (rampart doctor вместо rampart-cli doctor).
  • Документация приведена в соответствие с кодом: дефолты [xdp]/[detect], имена метрик XDP, таблица ClickHouse (rampart_events), восстановление Redis из RDB, путь к схеме конфига, команда сборки BPF с multiarch-инклюдом.

Removed

  • Неиспользуемое поле role в JWT claims (RBAC не реализован; вернуть вместе с реальными ролями).

[0.3.0-dev] — 2026-11-16

Big-bang редизайн: из Minecraft-специфичной защиты в универсальную L3/L4/L7 платформу.

Added

  • Единый пакет rampart с бинарями rampart, rampart-manager, rampart-cli, rampart-tui; Java-плагины и dashboard удалены.
  • Протокол-плагины: protocol-http (HTTP/1.1 request-head) и protocol-minecraft (handshake/list/login, один upstream, PROXY v2).
  • XDP: universal-фильтр для IPv4/IPv6, LPM blacklist/whitelist, SYN-throttle, UDP policy (pass/drop/rate-limit), prefix-статистика, RST-challenge, ringbuf-события и opt-in auto-ban.
  • Subnet-level detection: prefix-статистика /24 и /64, оценка числа источников по bitmap, лестница вердиктов strict → challenge → block.
  • Traffic Intel в горячем пути: EWMA-детектор, репутация, авто-баны, webhook алерты на переход состояния.
  • Manager API: pagination/SCAN вместо KEYS, rate-limit мутаций, body limit и таймауты, graceful shutdown, backfill метаданных blacklist, X-Forwarded-For только от MANAGER_TRUSTED_PROXIES.
  • PROXY protocol v2 на входе: строгая валидация адреса, доверенные CIDR, запрет бана доверенных сетей.
  • TUI-дашборд live-метрик; Prometheus /metrics.
  • Инфраструктура: fuzz-цели http_head и proxy_v2, criterion-бенчмарки горячего пути, e2e-тест edge на loopback, netns-скрипты XDP.

Changed

  • IPv6-паритет XDP: blacklist, UDP rate-limit, prefix-статистика, whitelist.
  • Expiry банов переведён на монотонные часы; просроченные префиксные баны удаляет userspace-reaper.
  • Тесты вынесены из src/ в tests/ (правило «тесты отдельно от кода»).

Fixed

  • XDP: длина TCP-payload по ip->tot_len (Ethernet-паддинг), VLAN/QinQ до L3, фрагменты по blacklist, чтение map до bpf_map_delete_elem (UAF), .rodata раскладка и имена карт в загрузчике.
  • Data path: backoff на accept(), корректный shutdown, глобальный бюджет, rate-limit до PoW, таймауты connect/handshake/relay.
  • Blacklist: CIDR-баны диапазонами, нормализация IPv4-mapped, TOCTOU, атомарный replace_redis.
  • Manager: auth bypass, утечки и зависания, найденные ревью.

Security

  • API_PASSWORD ≥ 16 символов и не changeme; JWT_SECRET ≥ 32 непробельных байт; audience-валидация.
  • syn_challenge_enabled требует собственный секрет, placeholder отклоняется.
  • Compose без публичных Redis/ClickHouse и без дефолтных паролей; пустой CORS_ORIGIN → cross-origin запрещён.

[0.2.0] — 2026-07-20

  • Первый публичный релиз: 6-слойный Minecraft-стек (XDP → PoW → Rust core → Velocity → Paper agent → Traffic Intel), Java-плагины и dashboard.