🛡️ GSC — Git Security Checker

English

GSC is a self-learning AppSec platform that proves exploits, verifies fixes, and heals CI.

detect → prove → fix → verify → heal → learn

Most scanners report matches. GSC proves them: every finding can be turned into a
runnable proof-of-concept, validated in a sandbox, then fixed and re-verified by
re-running the exploit.

What makes it different:

• 69 detectors across SAST, SCA, secrets and IaC — plus a YAML rule DSL.
• PoC auto-generation with a safe-exploitation gate: a finding ships with a working exploit, not just a line number.
• Proof-of-Fix — a patch is only accepted after the exploit stops firing in a sandbox.
• Self-learning — detectors are re-scored nightly against a calibration network; noisy patterns are auto-deactivated at <30% TP. Federated feedback is privacy-first ({tenant_hash, rule_id, tp, fp} + DP noise).
• Priority by exploitability, not CVSS — EPSS + CISA KEV + ExploitDB.
• BYO-LLM — the engine, detectors and PoC logic are ours; LLM revalidation runs on your key (any OpenAI-compatible endpoint, including a local Ollama). No key → fast regex-only mode.

Use it as a GitHub Action (see below) or from the CLI / Docker image.

MCP — in development, not shipped yet. The read-only MCP server (six tools:
scan_repo, scan_diff, list_findings, get_finding, verify_finding,
list_detectors) is built into the closed-source engine but is not available
in the public image today. Until it ships there is no MCP configuration to add —
use the Action or the CLI below. Star/watch the repo for the release.

Proven on real code: HALL_OF_FAME.md ·
first public case study: CASE_STUDY_CYBERBRO.md

Measured on 100 real GitHub projects

The same fixed corpus is re-scanned after detector changes — 100 real repositories
(90 clean + 10 known-vulnerable), pinned to specific commits, regex-only, no LLM key.
Same projects every run, so a delta is the fix and not a new dataset.

CRITICAL precision on a labeled review of 434 findings: ~4–5% at baseline → 31.1%
(TP = 135, FP = 299, 2026-08-26). That is still noisy. The remaining false-positive mass is
concentrated in GS001 (secrets), GS005 (SQLi), GS020 (XSS) and GS037 (path traversal) and is
worked down rule by rule — we publish the numbers we have, not the numbers we would like.

Method note: corpus, severity counting and per-rule aggregation are ours; the engine ships as
a closed image, so reproducing this means running gsc scan --ci --json over the same pinned
projects and aggregating the same way. No clean-room comparison against other vendors is implied.

License: this repo (Action, docs, marketing) is Apache-2.0. The engine ships as a
closed Docker image ghcr.io/poliakarmai/gsc-scanner under BSL 1.1 (free to scan your own
repos; competing SaaS requires a commercial license; converts to Apache-2.0 on 2030-08-06).

Case study: XSS in a 122★ OSINT platform (stars as of 2026-08-08)

First public proof — stanfrbd/cyberbro (46,677 LOC, 281 files):

Full write-up → CASE_STUDY_CYBERBRO.md ·
more findings in production OSS → HALL_OF_FAME.md

GSC — самообучающаяся AppSec-платформа полного цикла.

detect → prove → fix → verify → heal → learn

🚀 Быстрый старт — GitHub Action

Проверьте свой репозиторий за 30 секунд. Добавьте файл .github/workflows/gsc.yml:

name: GSC Audit
on:
  pull_request:
    branches: [main, master]

jobs:
  audit:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pull-requests: write
    steps:
      - uses: actions/checkout@v4
      - uses: poliakarmai/gsc@v1   # для воспроизводимости — pin на commit SHA
        with:
          fail_on_critical: false   # true = блокировать merge при CRITICAL

Откройте pull request — GSC отсканирует код, пришлёт комментарий с находками
(CRITICAL / HIGH) и поставит оценку безопасности. Ядро поставляется как
закрытый Docker-образ ghcr.io/poliakarmai/gsc-scanner — исходный код движка
не публикуется.

Воспроизводимость. @v1 и тег образа — плавающие ссылки: результат может
измениться без изменения вашего workflow. Для аудита/CI фиксируйте
poliakarmai/gsc@<commit-sha> и образ по digest
(ghcr.io/poliakarmai/gsc-scanner@sha256:<digest>).

Входные параметры:

Выходы: score (0–100) и grade (A+ … F).

Комментарий в PR считает находки по локациям (file:line), а не по
срабатываниям детекторов: один секрет, пойманый четырьмя правилами, — это
одна строка с перечислением правил, а не четыре. Total в таблице всегда
равен сумме категорий.

LLM-ревалидация — на вашем ключе (BYO-LLM):

- uses: poliakarmai/gsc@v1
  with:
    llm_api_key: ${{ secrets.DEEPSEEK_API_KEY }}   # DeepSeek / OpenRouter / GMI / Ollama

Без ключа — быстрый regex-only скан (уязвимости находит; confirmed-вердикты — с ключом).

Что умеет

Где что доступно. Возможности движка не равны возможностям Action/MCP:

Возможность	Action	MCP	CLI / engine image
Скан (SAST/SCA/Secrets/IaC)	✅	⏳ не поставляется	✅
PoC auto-generation	—	—	✅ (--with-poc)
Proof-of-Fix	—	—	✅ (pof generate)
Self-healing CI (авто-PR)	—	—	✅ (--create-pr, human-approval)

⏳ MCP-сервер написан и покрыт тестами в движке, но в публичный образ пока не
входит (fastmcp не входит в scanner-зависимости, команды gsc mcp нет).
Подключить его сегодня нельзя — раздел появится здесь, когда сервер доедет до образа.

Когда доедет: в MCP не будет деструктивных действий (auto-patch/PR) — осознанно,
они остаются в CLI/human-лупе. verify_finding перезапускает PoC в sandbox, то есть
по побочным эффектам это не «чисто read-only».

Что уже внутри (код, а не план)

🎯 Наша фишка: BYO-LLM — движок наш, судья твой

GSC — это движок + детекторы + PoC, а не очередная обёртка над LLM.

• От GSC: 69 детекторов, V3-scoring, FP-фильтр, PoC/PoF, self-learning — закрытый IP в Docker-образе.
• От вас: LLM-ключ (любой OpenAI-совместимый — DeepSeek/OpenRouter/GMI/локальный Ollama).

Почему это выгодно вам:

• Ноль расходов на чужие токены — ревалидация на вашем ключе.
• Никакой привязки к провайдеру — хоть бесплатный локальный Ollama.
• Вы платите за детекторы и логику, а не за вызовы LLM.

🧠 Второй столп: Self-Learning — детекторы обновляются сами, каждую ночь

Помимо BYO-LLM у GSC есть замкнутый контур обучения без LLM (0 токенов, детерминированный):

скан → авто-разметка findings по calibration-сети (16 проектов: 9 clean + 7 vuln)
     → авто-деактивация шумных паттернов (<30% TP)
     → пополнение эталонов из security-фидов
     → federated feedback (приватно: только {tenant_hash, rule_id, tp, fp} + DP-шум)

Детекторы учатся на реальных находках клиентов через federated-контур — то,
чего мейнстрим сознательно избегает (риск дрейфа). GSC обходит это консервативным
self-learning: разметка по фиксированной сети + дискретные деактивации, без
переписывания весов — скорость ежедневного апдейта без катастрофического дрейфа.

Никто не замыкает петлю обучения в проде — GSC закрывает этот зазор.
Подробно, с пруф-базой (доки вендоров + research-статьи) →
SELF_LEARNING.md.

Честная рамка. GSC не заменяет Semgrep/CodeQL: у них шире покрытие языков и
зрелее правила. GSC закрывает то, чего они не делают — доказывает находку PoC,
верифицирует фикс перезапуском эксплойта, учится на TP/FP. Рабочая схема — вместе:
зрелый сканер на массовый охват + GSC на закрытие конкретных находок.

🔌 Интеграции

Paperclip — «найми GSC как сотрудника по безопасности»

Paperclip (79K★, open-source оркестратор AI-агентов)
подключает GSC через MCP Tool Gateway — любой нанятый агент (Claude Code / Codex / Hermes)
получает GSC-инструменты и роль «Security Engineer».

⏳ Интеграция готова в движке, но не в публичной поставке. MCP-сервер
(6 инструментов: scan_repo · scan_diff · list_findings · verify_finding ·
get_finding · list_detectors) ещё не входит в публичный образ — см. раздел
«MCP» выше. Сценарий ниже заработает, когда сервер доедет до образа.

• Транспорт: local_stdio (subprocess) или mcp_remote (HTTP)

Подключение за минуты: зарегистрируй ToolStdioCommandTemplate, создай gateway — и GSC сканирует репозитории твоей Paperclip-компании.

Лицензия и доступ

Этот репозиторий (GitHub Action, документация, маркетинг) — Apache License 2.0. Свободно используйте Action в своих репозиториях.

Движок GSC (детекторы, PoC/PoF, калибровочная сеть, LLM-слой) поставляется отдельно как закрытый Docker-образ ghcr.io/poliakarmai/gsc-scanner под Business Source License 1.1 (BSL 1.1):

• Свободное использование — включая сканирование собственных репозиториев в production — разрешено всегда.
• Коммерческий SaaS/SAST-сервис для третьих лиц, конкурирующий с GSC, — требует коммерческой лицензии (после NDA).
• Change Date 2030-08-06 → движок автоматически переходит на Apache 2.0.

Для демо, пилота или приобретения — свяжитесь с автором.

© 2026 Алексей Поляков.