Skip to content

CHANGELOG.md

Latest commit

 

History

History
262 lines (231 loc) · 17.9 KB

CHANGELOG.md

File metadata and controls

262 lines (231 loc) · 17.9 KB
Raw

Changelog

Alle wesentlichen Änderungen an clutch werden hier dokumentiert.

Das Format orientiert sich an Keep a Changelog.

[0.4.2] - 2026-08-21 - CI Matrix Hardening, Python 3.13 & Security Parity

Added

  • GitHub Actions CI Workflow (.github/workflows/tests.yml) um Python 3.13 Matrix-Unterstützung (["3.10", "3.11", "3.12", "3.13"]) und automatisierten ruff check . Linter-Schritt gehärtet.
  • Python 3.13 Classifier ("Programming Language :: Python :: 3.13") in pyproject.toml ergänzt.
  • Direkte Sicherheitskontakt-E-Mail (security@ellmos.ai / support@lukasgeiger.com) in SECURITY.md (deutsch und englisch) integriert.
  • Automatisierte Metadaten- & Manifest-Paritätstestsuite in tests/test_metadata.py um CI-Matrix-, Ruff-Linting-, Pyproject-Klassifizierungs- und Sicherheitskontakt-Tests auf 7 Tests erweitert (338 Tests in Gesamt-Suite inkl. GPT-5.6 Cost-Routing-Suite).

Changed

  • llms.txt: Last-checked Timestamp auf 2026-08-21 und Test-Suite auf 338 Tests synchronisiert.
  • Shields.io-Badges in README.md & README_de.md auf 338 passed Tests aktualisiert.
  • Verifikation: 338/338 Pytest-Tests 100% grün, compileall & ruff check fehlerfrei.

[0.4.1] - 2026-08-16 - Discoverability, README-Design & Metadata Parity Check

Added

  • Automatisierte Metadaten- & Manifest-Paritätstestsuite in tests/test_metadata.py (4/4 passed).
  • Shields.io-Badges für Local-First-Sicherheit, Version (0.4.0), Discovery (llms.txt) und synchronisierte Pytest-Suite (314 passed, 100% grün) in README.md und README_de.md.
  • Geschwisterwerkzeuge-Matrix für das gesamte ellmos-ai-, dev-bricks- und open-bricks-Ökosystem (coma, swarm-ai, system-explorer, policy-registry, sqlite-transit-sync, workflowhooker, memoryhooker, DevCenter, CodeBox) zweisprachig integriert.
  • Standardisierte bilingual-strukturierte SECURITY.md mit Local-First-Routing, Keyring-Credential-Speicherung, Null-Telemetrie und privater Schwachstellenmeldung.
  • Ruff-Linter-Konfiguration ([tool.ruff] und [tool.ruff.lint], line-length 120, py310) in pyproject.toml.

Changed

  • llms.txt: Last-checked Timestamp auf 2026-08-16 und Test-Suite auf 314 Tests synchronisiert.
  • tests/test_m4_cli.py, tests/test_m5a_session_store.py, tests/test_m5b_prompt_library.py: Unbenutzte Test-Variablen bereinigt; ruff check . 100% sauber.
  • Verifikation: 314/314 Pytest-Tests 100% grün, compileall & ruff check fehlerfrei.

[Unreleased]

GPT-5.6 cost and empirical routing (2026-08-20)

  • GPT-5.6 Luna, Terra und Sol mit sechs Effort-Stufen, aktuellen Input-/Cached-Input-/Output-Preisen, Quellen, Preisversion und Frische-Signal katalogisiert.
  • OpenAI-Motor auf die Responses API umgestellt; angeforderter und effektiver Effort werden getrennt protokolliert. max-delegate bleibt ein Orchestrierungshinweis und gelangt nie als API-Wert nach außen.
  • Zentrale Kostenberechnung für Cached Input, Cache-Schreibvorgänge, Langkontext oberhalb von 272.000 Input-Tokens, Standard/Fast, Tool-Gebühren und einmalig berechnete Reasoning-Tokens ergänzt. Fehlende Usage bleibt ausdrücklich unbekannt und ungemessen.
  • SQLite-Telemetrie, Tankuhr, CLI-/Web-JSON und Statistik auf dieselbe Kostenquelle verdrahtet; bestehende Datenbanken werden additiv migriert.
  • Empirisches Aufgabenklassen-Routing mit externen Qualitätslabels, erwarteten Kosten pro Erfolg einschließlich Retry/Fallback, Qualitäts- und Latenz-Gates, Pareto-Frontier sowie belegfreiem Cold-Start ergänzt.
  • Zweisprachige Dokumentation, versionierte Eval-Profile, Kostenrechner und deterministisch generierte Preisgrafik ergänzt. Verifikation: 335 Pytests, Ruff, Compileall und Diff-Check grün.

Maintenance & Discoverability

  • Discoverability & Marketing Audit (2026-08-04): Synchronized llms.txt verification timestamp (2026-08-04) and pytest status (306 passed). Added ellmos-ai ecosystem and open-bricks umbrella badges to README.md and README_de.md. Verified 306/306 Pytest unit tests (100% green).

Added

  • Gemini 3.7 Flash als bevorzugter Flash-Gang (2026-08-13). Neuer Gang gemini-3.7-flash (Provider google, Modell-ID gemini-3.7-flash, G2, 1.048.576 Token Kontext, efforts low/medium/high). Anlass: Laut Nutzer ist die 3.7er-Generation stabiler und besser als die vorige [U 2026-08-13]; Modell-ID, Kontextfenster und Denkstufen sind gegen die Google-Doku verifiziert (catalog_source, geprüft am 2026-08-13).
    • Bevorzugung über die Katalogreihenfolge: Der Eintrag steht bewusst vor gemini-flash (3.5). Bei gleicher Stufe gewinnt der zuerst eingetragene Gang, daher laufen Up- und Downshift in die Flash-Stufe jetzt auf 3.7. gemini-flash (3.5) wurde nicht entfernt und bleibt als Fallback erreichbar. Die Reihenfolge-Abhängigkeit ist im _doc des Gangs vermerkt und durch Tests abgesichert.
    • Keine Umgewichtung: Stufe (G2) und staerken sind identisch zu gemini-flash, damit sich Budget-Downshift und Zweck-Auswahl unbeteiligter Modelle (z.B. ollama-mistral, claude-sonnet) nicht verschieben; ein Regressionstest hält das fest.
    • Nur auf dem Google-Weg: Eine Live-Probe der installierten agy-CLI (invalid-model-probe, 2026-08-13) listet weiterhin nur bis gemini-3.6-flash. Ein agy-gemini-3.7-flash-Gang wäre dort nicht ausführbar und wurde deshalb bewusst nicht angelegt; die agy-Familie bleibt unverändert.
    • Denkstufen: efforts dokumentiert die thinking_level-Stufen des Modells. Der GeminiMotor reicht sie noch nicht an die API durch — die Reasoning-Tiefe steuert clutch weiterhin über das Gaspedal.
    • Preise: Eingetragen ist der Einführungspreis (0,75/3,75 USD je 1M Token), der damit unter dem 3.5-Flash-Eintrag liegt. Ab 2027-01-01 gilt laut Google 1,50/7,50 — dann in getriebe.json nachziehen.
  • agy model registry and motor (2026-07-28): Six models live-verified against agy 1.1.8 are registered with effort variants and catalog provenance. AgyCompanionMotor executes them through companion-for-agy, maps Clutch effort levels to supported agy efforts, and keeps agy classified as an agentic CLI provider.
  • Aktueller Modellkatalog (2026-07-28): Claude Fable 5 ist als höchster G5-Gang registriert. Die direkten Gemini-Gänge nutzen gemini-3.5-flash und gemini-3.1-pro-preview; die nicht existente ID gemini-3.5-pro wird nicht verwendet.
  • OpenAI-/Codex-Provider (2026-07-28): OpenAIMotor erweitert den konfigurierbaren OpenAICompatibleMotor, nutzt OPENAI_API_KEY und max_completion_tokens. Registriert sind GPT-5.6 Sol, GPT-5.6 Terra und GPT-5.3-Codex mit aktuellen Katalogdaten.
  • Vollständiges Web-Settings-Panel (2026-07-28): Das einklappbare Panel spiegelt nun sowohl clutch keys als auch clutch config, zeigt erkannte Env-Key-Namen samt Quelle, zeigt niemals Credential-Werte und meldet Speicher-/Löschfehler sichtbar in der Oberfläche. Laufende API-Motoren lösen nicht explizit injizierte Credentials pro Verfügbarkeitscheck/Aufruf neu auf, sodass gespeicherte Keys ohne Serverneustart wirksam werden.

Documentation

  • README language parity (2026-08-01): Synchronized README_de.md with the canonical English structure and restored byte-identical code and Mermaid blocks across the maintained EN/DE pair.
  • Discoverability & Mermaid Architecture (2026-07-26): Embedded Mermaid system architecture flowchart diagram, LLM-ready discovery badges, and GFM > [!NOTE] callouts for llms.txt machine-readable metadata in both English and German documentation. Updated llms.txt verification timestamp to 2026-07-26 and verified 286 passing unit tests (100% green).
  • Discoverability & Marketing Refresh (2026-07-25): llms.txt Last-checked Datum auf 2026-07-25 und 286 passing unit tests verifiziert. Visual Shields.io Badges (Pytest 286 passed, Multi-Provider, LLM-Ready llms.txt), KI/LLM-Integrationshinweise und Mermaid Systemarchitektur- & Datenfluss-Diagramm in README.md und README_de.md integriert.
  • AI/LLM-Indexierung & Metadaten-Sync (2026-07-25): llms.txt Header auf Last-checked: 2026-07-25 aktualisiert; Referenzhinweis auf llms.txt in README.md und README_de.md ergänzt.

Security

  • Web-Token Auto-Generierung bei Loopback-Start (2026-07-28): Beim Aufruf von serve() auf Loopback-Hosts (z. B. 127.0.0.1) ohne gesetztes CLUTCH_WEB_TOKEN wird nun automatisch ein sicheres Zufalls-Token (secrets.token_urlsafe(32)) generiert und in die UI (index.html) injiziert. Dadurch ist die Web-API auch im reinen Loopback-Betrieb vor unbefugten Zugriffen anderer lokaler Prozesse geschützt.
  • Web-API härtung (Code-Review 2026-07-04). Die FastAPI-Web-UI war ohne jede Zugriffskontrolle erreichbar — inkl. Credential-CRUD (POST/DELETE /api/credentials) und Config-Schreiben (POST /api/config).
    • DNS-Rebinding-Schutz: TrustedHostMiddleware akzeptiert nur noch Loopback-Host-Header (localhost/127.0.0.1/::1, plus den Bind-Host bei absichtlichem Netzwerk-Bind). Eine bösartige Webseite kann die lokale API nicht mehr per Rebinding auslesen.
    • Optionales Token-Gate: Ist CLUTCH_WEB_TOKEN gesetzt, erfordert jeder /api/*-Zugriff Authorization: Bearer <token> (oder X-Clutch-Token); die UI-Seite selbst bleibt ungeschützt erreichbar.
    • Bind-Schutz: serve() verweigert den Start an einem nicht-loopback-Host (z. B. --host 0.0.0.0) ohne gesetztes CLUTCH_WEB_TOKEN und warnt beim Netzwerk-Bind.
    • CORS: allow_credentials auf False (keine Cookie-Auth), Origins auf die tatsächliche UI-Origin (mit Port) beschränkt.
  • credentials.json wird atomar mit 0600 angelegt (os.open mit engem Modus statt write_text + nachträglichem chmod) — kein Zeitfenster mehr mit zu weiten Rechten bei Neuanlage; das Elternverzeichnis wird auf 0700 gesetzt.

Fixed

  • Circuit-Breaker: consecutive_failures wird jetzt tatsächlich ausgewertet. Die aus der Fitness-Config geladene Schwelle (max_fehler_serie, Default 3) war nie referenziert; nur das Stundenlimit (5/h) löste aus. Fällt ein Modell bei niedriger Anfragefrequenz mit 3–4 Fehlern in Folge aus, öffnet der Breaker nun, statt weiter blind auf das kaputte Modell zu routen.
  • SQLite unter dem Web-Server: WAL-Modus + 15 s Busy-Timeout. Gleichzeitige /api/chat-Requests schrieben ohne WAL in dieselbe DB (DELETE-Journal sperrt exklusiv) und konnten sporadisch database is locked auslösen.

Packaging

  • PyPI-Vorbereitung (noch nicht veröffentlicht): Distributionsname clutch-router (Import bleibt clutch; clutch auf PyPI vergeben). package-data erweitert um locales/*.json + web/*.html (sonst fehlten i18n + Web-UI im pip-Paket). Classifiers/ keywords/URLs ergänzt. GitHub-Action publish.yml (PyPI Trusted Publishing/OIDC, triggert auf v*-Tags) — Release erfolgt erst nach der Testphase + einmaliger PyPI-Publisher-Einrichtung.

Added

  • Web-UI: CLI-/Env-Spiegel (M6+): Endpunkte GET/POST /api/credentials + DELETE /api/credentials/{name} und GET/POST /api/config; die vollständige Oberfläche ist im aktuellen Unreleased-Abschnitt dokumentiert. Tests in test_m12_web_settings.py (inkl. Wert-Leak-Schutz).

Fixed

  • Changelog-Hygiene: Die historische 0.3.0-rc1-Sektion steht jetzt vor dem finalen 0.3.0-Release, und die initiale Testreferenz nennt die tatsächliche Datei tests/test_clutch.py.
  • Ollama-Remote-Host wurde ignoriert: OllamaMotor lief bei Ausführung und Verfügbarkeitscheck stets gegen die bei Konstruktion gesetzte Basis-URL (Default localhost:11434) und ignorierte den per Discovery gesetzten Gang.endpoint. Dadurch war ein entdeckter Remote-Ollama-Host (z. B. im VPN) nie erreichbar. Jetzt bevorzugt der Motor Gang.endpoint und fällt nur ohne Endpoint auf die Basis-URL zurück; MotorBlock.ausfuehren prüft die Ollama-Verfügbarkeit gegen denselben Ziel-Host. Regressionstests in test_ollama_endpoint.py.

Added

  • Ollama-Timeout konfigurierbar: Der bisher fest auf 60 s gesetzte Basis-Timeout des OllamaMotor ist jetzt über den Konstruktor-Parameter timeout_basis bzw. die Env-Variable CLUTCH_OLLAMA_TIMEOUT (Sekunden) einstellbar. Grosse lokale Modelle (30B+) brauchen beim Kaltstart länger als der Cloud-orientierte Default; ohne Override bleibt das Verhalten unverändert (60 s). Tests in test_ollama_endpoint.py.

[0.4.0] -- 2026-06-14

Großer Ausbau von der Library zur Routing-Anwendung (CLI + Web + API), Kimi-Anbindung, Zweck-/bildbewusstes Routing, Modell-Discovery, Service-Layer, Credential-Store und i18n (en/de/es/zh/ja/ru). 270 Tests grün.

Added

  • App-Ausbau (DEVELOPMENT_PLAN.md M0–M7): clutch wird von der Library zur Routing-Anwendung.
    • M0 Engine: scorer.py (Komplexitäts-Score 0–100 + Zweck-/Modalitätserkennung), partner.py (Cross-Agent-Delegation mit Budget-Zonen + Mensch-Eskalation), Tankuhr/Token-Fluss im Fahrer verdrahtet, Budget-Zonen-SSOT (orange=G1–G2), DB-Pfad nach ~/.clutch (nicht ins Repo).
    • M1 Kimi-API: OpenAICompatibleMotor + KimiApiMotor (api.moonshot.ai/v1, MOONSHOT_API_KEY), Gänge kimi-api-code/kimi-api-vision mit voller Usage.
    • M2 Zweck-Routing: Gang-Auswahl nach staerken-Tags (coding/vision/...), bildbewusst (Bild-Anhang → Vision-Modell), respektiert Budget-Limit.
    • M3 Discovery: discovery.py (Ollama /api/tags lokal+remote, /v1/models, custom_models.txt).
    • M4 CLI: cli.py + [project.scripts] clutch (route/models/config/stats/run/chat).
    • M5 Service-Layer: session_store.py (Sessions+Verlauf), prompt_library.py (+PromptBoard-Import), profile_manager.py (user/zweck/toolset-Profile + Systemprompt-Toggle), chat_runtime.py (Konversation über dem Router) + CLUTCH.md (mitlieferbarer Systemprompt).
    • M7 Toolsets: toolsets.py (Tool-Permissions default-deny, ControlCenter-Katalog-Bridge, versendbares Toolset-Paket).
    • M6 Web-UI: webapp.py (FastAPI, optionale Dependency clutch[web]), web/index.html (Vanilla-JS-Chat mit Bild-Upload, Sessions, Stats, Systemprompt-Toggle), clutch serve --web.
    • M8: Migrationsanleitung „BACH übernimmt clutch" (docs/BACH_MIGRATION.md, gegatet).
    • Phase 9 /bugsweep: 3 Reviewer-Agenten (Security/Routing/Robustheit) → Fixes: zone_nummer fail-safe (unbekannt→restriktivste Zone), untrusted Web/API schließt agentische CLI-Motoren mit Auto-Approve aus, Vision-Warnung wenn kein Vision-Modell, webapp generische 500-Fehler + Upload-Limit (10 MB), loesche() cursor-in-with, import_promptboard robust gegen kaputtes/fehlendes JSON, LIKE-Escape in Prompt-Suche. Regressionstests in test_m9_bugsweep_fixes.py.
    • Credentials-Store: credentials.py — lokaler API-Key-Speicher ~/.clutch/credentials.json (zero-dep, 0600-Rechte). Auflösung Env → clutch-Store → BACH-~/.credentials/<name> (Interop). Motoren (Anthropic/Gemini/Kimi-API) nutzen den Resolver; CLI clutch keys set|list|remove (Werte nie angezeigt). Kimi-API live verifiziert (kimi-k2.7-code → PONG, Usage erfasst).
    • Tests: +~160 (test_m0..m10), Gesamtsuite 236 passed (py -m pytest).
  • Kimi-Anbindung: Drei Gänge für Moonshots Kimi ergänzt. (1) kimi-cli und kimi-code als agentische CLI-Motoren (KimiCliMotor/KimiCodeMotor in motorblock.py) — Subprozess im Print-Modus, Login via Moonshot-Account (kein API-Key), ohne Token-/Usage-Tracking. (2) ollama-kimi-k2 (kimi-k2.7-code:cloud) als Rohmodell über den vorhandenen OllamaMotor — Token-Usage wird erfasst; läuft über Ollama Cloud (nicht lokal). Neue Tests in tests/test_kimi_motoren.py (Gang-Registrierung, Factory-Mapping, argv/Output-Parsing per gemocktem Subprozess, Fehlerpfad).
  • GLOSSARY.md für die deutschen Code-Begriffe der Auto-Metapher.
  • GitHub Actions Test-Workflow für Python 3.10 bis 3.12.

Changed

  • README-Quickstart, Projektstruktur und Testanleitung an das tatsächliche Paket clutch angepasst.
  • Community-Workflows auf aktuelle Actions-Versionen aktualisiert.
  • Default-Konfiguration in clutch/config/ paketiert, damit Wheel-Installationen die Routing-Defaults enthalten.
  • Pytest-Konfiguration auf tests/ begrenzt, damit manuelle Provider-Smokes im Repo-Root nicht als Unit-Tests gesammelt werden.
  • TODO.md um einen aktuellen Public-Readiness-Status ergänzt und .gitignore um ein explizites *.pyc-Muster erweitert.
  • llms.txt um Last-checked, Audience und Suchphrasen für LLM-/Crawler-Discovery ergänzt.

[0.3.0-rc1] -- 2026-03-15

Changed

  • Repo-Referenzen auf ellmos-ai/clutch aktualisiert
  • BACH-interne Dokumente (BACH_EINHAENGEPUNKTE.md, BACH_INTEGRATION.md) entfernt
  • Personenbezogene Daten bereinigt

Fixed

  • .gitignore um BACH-Dateien ergänzt

[0.3.0] -- 2026-03-12

Erster öffentlicher Release als ellmos-ai/clutch.

Added

  • Provider-neutrale LLM-Orchestration mit Auto-Metapher (Fahrer, Getriebe, Kupplung, etc.)
  • Multi-Provider-Support: Anthropic (Claude), Google (Gemini), Ollama (lokal), Claude Code
  • Streckenanalyse (Task-Klassifikation) mit 10 Streckentypen (Feldweg bis Langstrecke)
  • Getriebe: Modell-Registry mit 8 vordefinierten Gängen (G1--G5)
  • Kupplung: Automatischer Modellwechsel basierend auf Strecke, Budget und Health
  • Gas/Bremse: Reasoning-Level-Steuerung (0%--100%)
  • Tankuhr: Budget-Tracking mit 4-Zonen-System (green/yellow/orange/red)
  • Bordcomputer: Health-Monitor mit Circuit-Breaker pro Modell
  • Fahrtenbuch: SQLite-basierte Metrik-Speicherung
  • Fahrschule: Lernengine mit Epsilon-Greedy Exploration und Fitness-Scoring
  • Tacho: Metriken-Erfassung während der Laufzeit
  • Execution Patterns: Einzelfahrt, Kolonne (Chain), Team (Parallel), Schwarm (Bulk), Hybrid
  • JSON-basierte Konfiguration (getriebe.json, strecken.json, kupplung.json, fitness_criteria.json)
  • 13 initiale Unit-Tests (tests/test_clutch.py)
  • README mit Architektur-Diagramm und Quick Start
  • MIT-Lizenz