smlflg/KomandoZentral

Kommandozentrale

Deterministische, regelbasierte Routing-Engine fuer AI-Harnesses mit CLI und lokaler Web-UI.

Installation

Empfohlener Dev-Setup:

uv sync --dev

Alle Kommandos danach ueber die projektlokale Umgebung starten:

uv run python -m kz --help

Alternativ editable Install in eine aktive Virtualenv:

pip install -e .

Verwendung

uv run kz "Plane Phase 3 fuer Komandozentrale"
uv run kz "Fixe Bug in agent.py" --codebase-depth single-file --blast-radius isolated --cause-ambiguity known --reversibility easy --verification auto-tests
uv run kz "Recherchiere Alternativen zu SQLite" --focus high --mode exploration
uv run python -m kz "Plane Phase 4 fuer Kommandozentrale"

Web-UI

uv run kz-web

Alternativ:

uv run python -m uvicorn kz.web:app --reload

Danach im Browser: http://127.0.0.1:8000

Planungsdokument: WEB_UI_PLAN.md

Beta-Handoff:

• BETA_SCOPE.md
• OPENCODE_HANDOFF.md
• OPENCODE_PROMPT_BETA.txt

CLI-Flags

Operator-State

Flag	Werte	Default
--focus	high/medium/low	medium
--adhd-risk	high/normal	normal
--drift-risk	high/normal	normal
--energy	high/low	high
--mode	exploration/shipping/default	default
--cost-tolerance	sparend/normal/quality-first	normal

Task-Modifier (für BUILD/ANALYZE)

Flag	Werte
--codebase-depth	single-file/multi-file/full-codebase
--blast-radius	isolated/multi-file/production-critical
--cause-ambiguity	known/suspected/unknown
--reversibility	easy/hard/destructive
--verification	auto-tests/manual-tests/no-tests

Persistenz

Flag	Beschreibung
--save	Speichert Entscheidung nach DECISIONS/

Confidence-Logik

Bereich	Bedeutung
>= 70	Direkt nutzbare Empfehlung
50-69	Hypothesentest mit experiment-Block
< 50	Keine operative Empfehlung

Output

YAML-Format gemäß DECISION_OUTPUT_SCHEMA.md.

API

• GET /health
• POST /api/route
• GET /api/decisions
• GET /api/decisions/{filename}

Die Web-UI unter / nutzt dieselbe Routing-Pipeline wie die CLI.

Tests und Qualitaet

uv run pytest -q
uv run ruff check .
uv build

Hinweis: DECISIONS/ und DATA/ sind Laufzeit-Ausgaben und werden absichtlich nicht versioniert.

Dateistruktur

KomandoZentral/
├── kz/                  # lokaler Shim fuer `python -m kz`
├── src/kz/
│   ├── cli.py           # CLI-Einstieg
│   ├── service.py       # Gemeinsame Routing-Pipeline
│   ├── web.py           # FastAPI + Web-UI
│   ├── models.py        # Enums + Dataclasses
│   ├── classify.py      # Heuristische Klassifikation
│   ├── operator_state.py # Operator-State-Defaults
│   ├── registry.py      # Harness-Profile
│   ├── rules.py         # Stufe-1 + Stufe-2 Routing
│   ├── confidence.py    # Confidence-Berechnung
│   └── persist.py       # YAML-Serialisierung
├── DECISIONS/           # Routing-Entscheidungen
└── DATA/
    └── outcomes.yaml    # Outcome-Tracking