backend/gsd/README.md

Grantforge GSD — Główny Tryb Działania

Od maja 2026 GSD (Grantforge Spec-Driven Development) jest głównym sposobem działania całego systemu.

Struktura

• gsd_orchestrator.py — centralny mózg (fazy, Konstytucja, polski HitL, audyt)
• gsd_state.py — rozszerzony stan z PolishHitlQuestion i audit_trail
• bridge.py — most do rzeczywistych agentów z backend/agents/
• email_notifier.py — wysyłka pytań zatwierdzających na Gmail
• run_gsd_project.py — zalecany runner do uruchamiania procesów
• docs/ — Konstytucja i SWARM (wczytywane przez agenty)

Jak uruchomić (główny tryb)

cd backend
python -m gsd.run_gsd_project --project-id "proj-123" --nip "5260000000"

Lub z poziomu API (po podłączeniu):

from backend.gsd.gsd_orchestrator import GrantforgeGSDOrchestrator
from backend.gsd.gsd_state import create_gsd_state

state = create_gsd_state(project_id=project.id, profile=profile)
orch = GrantforgeGSDOrchestrator(state)
final_state = orch.run_full_gsd_flow()

Polskie Pytania Zatwierdzające

W kluczowych momentach (Clarification, Matching, Audyt, Export) system generuje pytanie po polsku i może je wysłać mailem (Gmail).

Integracja z istniejącym kodem

• Rzeczywiste agenty (wizard_node, matcher_node, auditor...) są wywoływane przez bridge.py.
• Stary supervisor.py jest traktowany jako legacy / komponent niskiego poziomu.
• GSD narzuca Konstytucję i pełny ślad audytu na cały proces.

Status

GSD jest aktywny jako główny tryb działania.