Skip to content

STATUS.md

Latest commit

 

History

History
158 lines (116 loc) · 13.4 KB

STATUS.md

File metadata and controls

158 lines (116 loc) · 13.4 KB
Raw

Agora — Status

Stand: 06.08.2026
Geprüfte Main-Baseline: cc478627
Produktversion: 0.9.0 Stability Beta

Diese Datei beschreibt ausschließlich den verifizierten Istzustand. Strategische Release-Ziele stehen in ROADMAP.md, konkrete Arbeitspakete in GitHub Issues, ausgelieferte Änderungen in CHANGELOG.md.

Historische Pläne sind keine aktiven Steuerungsquellen: docs/archive/planning/

Versionsstatus

Die Produktreife wird ab diesem Dokumentationsumbau über VERSION geführt.

Komponente Pfad Version
Backend backend/pyproject.toml 0.9.0
Frontend frontend/package.json 0.9.0
Root package.json 0.9.0

VERSION ist die Produkt-SSoT. Alle Komponentenmanifeste (backend/pyproject.toml, package.json, frontend/package.json) und der README-Badge sind auf VERSION=0.9.0 synchronisiert; ein Drift-Check läuft in CI (version-drift.yml) und lokal (pre-push-gate.sh schemas). Der Version-Cut-Ablauf ist in docs/runbooks/release-versioning.md beschrieben.

Tests

Kategorie Anzahl Methode
Backend Tests (collected) 4577 cd backend && uv run pytest --collect-only -q
Frontend Test-Files 185 find frontend/src \( -name '*.spec.ts' -o -name '*.spec.js' -o -name '*.test.ts' -o -name '*.test.js' \)

Hinweise:

  • Zwei Redis-Integrationstests skippen ohne TEST_REDIS_URL kontrolliert.
  • Die Frontend-Zahl zählt Testdateien, nicht einzelne Testfälle.
  • Die Zahlen stammen aus dem letzten synchronisierten Status und müssen nach größeren Merges erneut erzeugt werden.

Produktreife

Agora besitzt eine vollständige fachliche Grundpipeline:

  • resumierbares Onboarding und lokales Benutzerprofil
  • Provider-Verbindungen, Secret Store und Modell-Discovery
  • getrennte Chat- und Embedding-Konfiguration
  • Dokument-/Webseitenaufnahme und Knowledge-Graph-Build
  • Persona-Erzeugung, Review und Simulation
  • Run-Dashboard, Status, Stop/Pause/Resume und Live-Ereignisse
  • Evidence-orientierte Reports und Exporte; ein einzelner ADR-0002-Verstoß beendet den Report nicht mehr als failed, sondern wird lokal abgestuft und maschinenlesbar protokolliert (#1006). Der JSON-Export normalisiert Evidence über dieselbe kanonische Kette wie der Lese-Pfad und weist eine nicht auslieferbare Evidence-Map im Envelope aus, statt sie stumm zu verwerfen (#987); ZIP-, CSV- und Streaming-ZIP-Export lesen dieselbe normalisierte Sicht (#1036); die Evidence-Sub-Routen normalisieren noch nicht (#967)
  • Compare-, Graph-Diff- und Observability-Grundlagen
  • fortsetzbare Embedding-Migration für Entity- und Fact-Vektoren
  • Kosten-, Token- und Zeitbudgets für Runs (#764, ADR-0012): Preflight-Schätzung mit ehrlichen Bereichen, weiche/harte Limits pro Run, Live-Verbrauchsmonitor, Abschlussanalyse nach Stage/Provider/Modell, Budgetabbruch über termination_reason von Fehler/Nutzerabbruch unterscheidbar, Verbrauch im Report-Export

Der Stand ist 0.9.0 Stability Beta; die innerhalb der 0.9.x-Linie noch offenen Freigabekriterien stehen unter 0.9.0 in ROADMAP.md. Die E2E-Kernpipeline wird seit 31.07.2026 als verpflichtender Pull-Request-Check erzwungen. Die Migration der v3-Inhaltskomponenten (Step2EnvSetup/Step3Simulation/Step4Report) in v4-Wrapper ist abgeschlossen (#922, PR #938); der credential-basierte Runtime-Provider-Override (useRuntimeLlmOptions) ist entfernt. Der /home-Redirect auf /dashboard ist umgesetzt (#915, ADR-0010); Home.vue bleibt bis 1.0.0 physisch erhalten.

E2E-Smokes

Issue #739 (sechs rote E2E-Smokes reparieren) ist geschlossen (19.07.2026). Seither laufen die sechs Kern-Smokes (Health, Upload + Graph, Minimalreport, Report-Modi, Golden-Gate Accessibility, AiModelPicker) im e2e-smokes-Workflow durchgehend grün: 20 von 20 aufeinanderfolgenden Läufen über push und pull_request zwischen 21.07.2026 und 22.07.2026 (letzter Lauf auf Commit 37320dbf) sind erfolgreich, kein einzelner Flake in dieser Serie.

Die Erzwingung ist umgesetzt (Stand 31.07.2026): main ist branch-protected und führt 17 Required Status Checks, darunter alle sechs E2E-Kern-Smokes sowie die beiden PR-Smoke-Gates. strict: true (Branch muss vor dem Merge aktuell sein), enforce_admins: true, Force-Pushes und Löschung deaktiviert, required_approving_review_count: 0 (Single-User-Betrieb).

Verifikation: gh api repos/arn0ld87/agora/branches/main/protection. Konfiguration und Rollback in docs/runbooks/e2e-required-check.md.

Der frühere Text an dieser Stelle behauptete, main habe keine Branch-Protection (mit einem 404 als Beleg). Das war zum Zeitpunkt des CI-/E2E-Audits am 31.07.2026 nachweislich überholt — es bestanden bereits 15 Required Checks.

Quality Gates

Gate Status
Backend PR Smoke: Ruff + Mypy + Contract-Tests verpflichtend
Frontend PR Smoke: Lint + Typecheck + Unit-Tests + Build verpflichtend
Backend Full Tests + Coverage push:main oder Label
Frontend Full Tests + Coverage push:main oder Label
Schemas und Contract-Spiegel vorhanden
E2E-Kernpipeline pull_request-Trigger aktiv; als Required Check erzwungen (alle sechs Smokes, Stand 31.07.2026)
Branch-Protection main aktiv — 17 Required Status Checks, strict: true, enforce_admins: true, keine Force-Pushes, keine Löschung

Lokale Befehle:

bash scripts/pre-push-gate.sh
bash scripts/pre-push-gate.sh backend
bash scripts/pre-push-gate.sh frontend
bash scripts/pre-push-gate.sh schemas

Coverage-Baseline

Die Werte sind älter als der aktuelle Codebestand und müssen für 0.9.0 neu erzeugt werden.

Bereich letzte Messung Ergebnis CI-Schwelle
Backend gesamt 10.06.2026 66,00 % 60 %
Frontend Statements 10.05.2026 50,46 % 28 %
Frontend Branches 10.05.2026 39,56 % 28 %
Frontend Functions 10.05.2026 38,59 % 28 %
Frontend Lines 10.05.2026 52,50 % 28 %

Strukturelle Lücken liegen vor allem in OASIS-/Neo4j-Integrationspfaden, Canvas-/WebGL-Komponenten und großen Wizard-/View-Komponenten.

Kanonische technische Pfade

  • API-Verträge: backend/app/contracts/
  • Frontend-Spiegel: frontend/src/contracts/ und schemas/
  • Provider-Erkennung: backend/app/llm/providers/registry.py::detect_provider
  • Provider-Verbindungen: ProviderConnection
  • kanonische Route: AiRoute / LlmRoute
  • kanonische Modellauswahl: frontend/src/components/v4/forms/AiModelPicker.vue; seit Issue #890 auch im Step-2-Environment-Setup. Eine Auswahl ist eine AiModelRef und wird als ai_model_ref an /prepare gesendet; ohne Auswahl entscheidet die Backend-Präzedenz (Projektprofil vor Workspace-Default). Modellauswahl wird im Frontend nicht mehr persistiert
  • aktive Embedding-Konfiguration: embedding_service.py und embedding_migration.py
  • Normalisierung persistierter Evidence-Maps: evidence_migrations.py::normalize_persisted_evidence_map — bindende Migrationsreihenfolge, Aufrufer sind der Lese-Pfad GET /api/report/<id>/evidence und der JSON-Export. Migrationsschritte nicht einzeln aus neuen Consumern aufrufen (#987)
  • strukturierte LLM-JSON-Outputs: LLMClient.chat_json mit Pydantic-Schema (strict-json_schema-Pfad); rohe OpenAI-Clients für strukturierte Outputs vermeiden
  • Subagent-Dispatch: Routing-Matrix in docs/runbooks/subagent-routing.md und CLAUDE.md; Agentdefinitionen unter .claude/agents/*-m3.md. Der -m3-Suffix ist seit dem 31.07.2026 nur noch ein historischer Name: die Definitionen trugen model: MiniMax-M3 (ab 20.07.2026) und waren damit nicht dispatchfähig — sie laufen jetzt auf Anthropic-Modellen (opus für den Reviewer, sonst sonnet). Die historischen Subagenten ohne Suffix (z. B. agora-doc-worker.md) wurden am 27.07.2026 auf denselben Härtungsgrad gehoben.
  • Evidence-Gating: ADR-0002-Hartanker

Chat-Routing und Embedding-Konfiguration bleiben getrennte Vertragswelten.

Bekannte Konsolidierungsschuld

  • die fünf klassischen Prozess-Wrapper-Views sind entfernt; ihre benannten Deep-Links bleiben als v4-Redirects kompatibel. /agora-2026 ist als Designreferenz unter docs/design-reference/agora-2026/ archiviert und nicht produktiv geroutet; v4-Ballast-Views sind entfernt (PR #877). Die Migration der v3-Inhaltskomponenten Step2EnvSetup.vue/Step3Simulation.vue/Step4Report.vue in v4-Wrapper ist abgeschlossen (#922, PR #938). Der /home-Redirect auf /dashboard (#915) ist umgesetzt
  • ein React-/Lovable-Neubau ist als Prototyp umgesetzt, aber nicht als Zielentscheidung freigegeben (Details im nächsten Abschnitt)
  • Legacy-LLM-Profile und Provider-Connections besitzen noch Übergangspfade
  • der credential-basierte Runtime-Provider-Override (useRuntimeLlmOptions) ist entfernt (PR #938); useEnvForm führt modelOption/customModel ohne Persistenz weiter, bis Issue #903 die Ablösung abschließt
  • die Browser-Keys agora.lastModel und agora.lastCustomModel haben seit Issue #890 keinen produktiven Reader oder Writer mehr; vorhandene Werte werden bewusst nicht gelöscht und bleiben wirkungslose Altlast
  • einzelne Provider-Erkennungen beruhen weiterhin auf URL-/Modell-Heuristiken
  • Frontend- und Backend-Provider-Vokabular sind nicht an jeder SSE-Grenze synchron

Frontend-Next-Stand (React/Lovable)

  • Produktiv: Vue ist die einzige ausgelieferte Frontend-Technologie. /home leitet seit #915 per ADR-0010 auf /dashboard um; die klassische Editorial-View Home.vue bleibt bis 1.0.0 physisch erhalten. Die Konsolidierung auf genau eine v4-Route je fachlicher Hauptfunktion ist mit Issue #760 verifiziert abgeschlossen (siehe #839). Die v3-Inhaltskomponenten Step2EnvSetup.vue/Step3Simulation.vue/Step4Report.vue sind nach v4 migriert und werden nicht mehr über v4-Wrapper geroutet (#922, PR #938).
  • Prototyp: Ein Lovable-Projekt („Agora Runs Dashboard", angelegt 2026-07-16) existiert und wurde substanziell umgesetzt (23 Edits, TanStack-Router-SPA, 12 Routen, shadcn/ui). Es ist derzeit nicht veröffentlicht (is_published: false, keine URL) und nicht produktiv verdrahtet — weder Docker-Compose, GitHub-Workflows noch das Root-package.json referenzieren es. Der React-Code liegt vollständig außerhalb dieses Repositories. Die tatsächliche Funktionsvollständigkeit des Prototyps ist nicht codegeprüft belegt, sondern nur durch Commit-Aussagen behauptet.
  • Release-Status: Kein Teil des freigegebenen Produktpfads vor 1.0.0.
  • Zukunft: Über eine spätere Migration ist keine Entscheidung getroffen.
  • Beleg: docs/epics/frontend-next/2026-STATUS.md.

Security und Betrieb

  • Betriebsmodell: experimentelles Single-User-System, kein öffentliches SaaS
  • Zugriff bevorzugt über Tailscale, VPN oder Reverse Proxy
  • API-Auth über AGORA_AUTH_TOKEN
  • SSE und Downloads über signierte Tickets
  • Secrets werden nicht in Report-/Simulation-Artefakte serialisiert
  • Credential-behaftete LLM-Requests erzwingen HTTPS; http:// ist nur für lokale/private Hosts zulässig, dokumentierte Ausnahme über AGORA_LLM_ALLOW_INSECURE_HTTP (Issue #1103)
  • Readiness prüft Neo4j, Redis, Upload-Verzeichnis und Embedding-Konfiguration
  • Dependency-Ausnahmen werden im dependency-risk-register.md geführt
  • Ontology-Upload (/ontology/generate) räumt bei Datei-I/O-Fehlern zwischen Projektanlage und Service-Übergabe das halb angelegte Projekt zuverlässig auf (Issue #899); ein scheiterndes Aufräumen wird protokolliert, ohne die Fehlerantwort zu verfälschen

Aktuelle Hardstops:

  • NLTK-Advisories: 28.09.2026 gemäß ADR-0004/Risk Register
  • Trivy OS-Layer: 30.08.2026 — entfällt, aufgelöst am 31.07.2026 (#772). CVE-2026-24049 und CVE-2026-23949 kamen nicht aus dem OS-Layer, sondern aus setuptools/_vendor/ in der Backend-.venv, und sind mit setuptools 83.0.0 behoben.

Nächste Prioritäten

  1. Hartes Run-Budget im Report-Pfad reparieren — greift derzeit nicht (#978, Kostenkontrolle).
  2. Reproduzierbarkeit, ehrliche Hardware-Tiers (Benchmarks statt Schätzwerte) und Kalibrierungsbaseline für 0.10.0 umsetzen. Die Kosten- und Ressourcenbudgets selbst stehen via #764 — siehe ROADMAP „Kosten und Ressourcen“.

Die vollständigen Release-Gates stehen in ROADMAP.md.