v4.1.0 public release0 runtime dependenciesMIT License

$pegas

Оркестратор L7-маршрутизации и автоматического SSL для мультипроектных VPS. Объединяет Docker и Caddy 2 в декларативный контракт, исключает конфликты портов и нативно управляется AI-агентами (Cursor, Claude, Copilot).

$npx @netrunner714/pegas init

Ключевые преимущества

Zero Port Collisions

Никакой проект на сервере больше не пытается занять 80 или 443 порт. Трафик принимает единый Caddy-шлюз (~30 MB RAM) и проксирует его по изолированной Docker-сети.

SRE Защиты & Pre-flight DNS

Проверяет совпадение DNS A/AAAA-записей с IP сервера до обращения к Let's Encrypt (исключая рейт-лимиты), проверяет готовность контейнеров и блокирует захват чужих доменов.

Мгновенный локальный HTTPS

Команда pegas connect поднимает общий Caddy-шлюз и выдаёт dev-домены *.localhost с доверенными сертификатами через pegas ca install.

Agent-Native архитектура

ИИ-кодинг агенты получают готовые спецификации llms.txt, контракт pegas.json и флаг --json во всех командах.

Декларативный контракт: pegas.json

{
  "$schema": "https://pegas.netrunner714.ru/schemas/pegas.json",
  "projectName": "shop",
  "scenarios": ["development", "stage", "production"],
  "services": {
    "web": {
      "runtime": {
        "development": { "driver": "bun" },
        "stage": { "driver": "docker" },
        "production": { "driver": "docker" }
      },
      "port": { "development": 3000, "stage": 3000, "production": 3000 },
      "domains": {
        "development": ["web.shop.localhost"],
        "stage": ["web-shop.idea2app.ru"],
        "production": ["shop.com"]
      }
    }
  }
}

Основные команды CLI

npx @netrunner714/pegas initАртефакты для агентов: docs/pegas.md, AGENTS-блок, .gitignore
npx @netrunner714/pegas connectDev-домены *.localhost через общий шлюз с локальным HTTPS
npx @netrunner714/pegas deploy -s productionДекларативный деплой сценария: DNS pre-flight, readiness, hot-reload Caddy
npx @netrunner714/pegas statusЕдиный дашборд проектов, сервисов, доменов и здоровья контейнеров
npx @netrunner714/pegas downЧистая остановка контейнеров и удаление маршрутов из шлюза