SnapKitty GitLab Connector

  ██████╗ ██╗████████╗██╗      █████╗ ██████╗
 ██╔════╝ ██║╚══██╔══╝██║     ██╔══██╗██╔══██╗
 ██║  ███╗██║   ██║   ██║     ███████║██████╔╝
 ██║   ██║██║   ██║   ██║     ██╔══██║██╔══██╗
 ╚██████╔╝██║   ██║   ███████╗██║  ██║██████╔╝
  ╚═════╝ ╚═╝   ╚═╝   ╚══════╝╚═╝  ╚═╝╚═════╝
 ⬡ Ω ↺ Ψ Δ Λ Σ Φ α — SOVEREIGN GITLAB CONNECTOR

GitLab → ROBOB Shadow Orchestrator → Frankenstein (Brain/Hands/Legs) → ABZU IDE

Pipeline Architecture

 GitLab Event
     │
     ▼
 ┌─────────────────────────────────┐
 │  WEBHOOK RECEIVER  :4700        │
 │  Push / MR / Pipeline / Note    │
 │  WORM-sealed on arrival         │
 └──────────────┬──────────────────┘
                │
                ▼
 ┌─────────────────────────────────┐
 │  ROBOB SHADOW ORCHESTRATOR      │
 │  Classifies event → pipeline    │
 │  code-review / mr-review /      │
 │  diagnose / command / job-fix   │
 └──────────────┬──────────────────┘
                │
                ▼
 ┌─────────────────────────────────┐
 │  FRANKENSTEIN  :4300            │
 │  🧠 Brain  (Claude Sonnet 4.6)  │
 │  🖐 Hands  (FAISS + Neo4j)      │
 │  🦵 Legs   (Granite Code 3B     │
 │             RTX 3080 local GPU) │
 │  🔍 Review (Claude Sonnet 4.6)  │
 └──────┬────────────────┬─────────┘
        │                │
        ▼                ▼
 GitLab MR Comment   ABZU Sovereign IDE
 (auto-posted)       (Phoenix LiveView
                      live dashboard)

Quick Start

npm install
GITLAB_WEBHOOK_SECRET=your-secret \
GITLAB_TOKEN=glpat-xxxx \
FRANKENSTEIN_URL=http://localhost:4300 \
ABZU_URL=http://localhost:4000 \
npm start

Server starts on :4700.

GitLab Webhook Setup

In your GitLab project → Settings → Webhooks:

• URL: https://your-server:4700/webhook
• Secret: (match GITLAB_WEBHOOK_SECRET)
• Events: Push / Merge Requests / Pipeline / Jobs / Comments

GitLab CI Component

include:
  - project: SNAPKITTYWEST/snapkitty-gitlab
    file: gitlab-ci-component/snapkitty.yml
    ref: main

Adds two jobs:

• snapkitty-sovereign-review — full Brain/Hands/Legs review on MR/main push
• snapkitty-security-gate — fast security-only scan on every push

/snapkitty Commands in MR Comments

Type in any MR comment:

/snapkitty review this PR for WORM violations
/sk explain the double-entry logic in accounting.mjs
/snapkitty generate tests for the new endpoint

ROBOB routes the command through Frankenstein and posts the result back.

Environment Variables

Variable	Default	Description
PORT	4700	Webhook server port
GITLAB_WEBHOOK_SECRET	sovereign-snapkitty	GitLab webhook token
GITLAB_TOKEN	—	GitLab PAT for posting comments
GITLAB_URL	https://gitlab.com	Self-hosted GitLab URL
FRANKENSTEIN_URL	http://localhost:4300	Frankenstein workflow server
ABZU_URL	http://localhost:4000	ABZU Sovereign IDE
ABZU_SECRET	sovereign-abzu-bridge	ABZU push signing key

WORM Chain

Every GitLab event + every Frankenstein result is sealed to .worm/gitlab_chain.jsonl. SHA-256 chained — tamper-evident from first event.

⬡ Ω ↺ Ψ Δ Λ Σ Φ α