Skip to content

Poortwachter: deterministische eerste laag voor GrowKit-routering (trap 1) - #4

Draft
parvenuprompting wants to merge 1 commit into
mainfrom
feat/poortwachter
Draft

parvenuprompting wants to merge 1 commit into
mainfrom
feat/poortwachter

Conversation

@parvenuprompting

Copy link
Copy Markdown
Owner

Wat

De Poortwachter: een deterministische eerste laag vóór de LLM-routering.
Gebouwd op verzoek van Tiëndo (1 okt 2026), ontwerp naar de review van Claude
op het oorspronkelijke voorstel.

Drie trappen in plaats van twee:

  1. Regels eerst — gratis, 100% voorspelbaar. @naam-mention routeert
    direct naar die agent; een machine-alert van een eigen script draagt zijn
    ernst zelf.
  2. Classifier — alleen voor vrije tekst van buiten. Pluggable: een
    callable (tekst) -> (klasse, confidence). Standaard None.
  3. LLM — bij twijfel.

Harde regels (met de router zelf als handhaver)

  • Machine-alerts en security-meldingen gaan nooit door een
    probabilistisch filter (bron=script slaat trap 2 over).
  • Ruis wordt nooit weggegooid, alleen gedegradeerd en append-only gelogd.
  • Drempel per klasse, niet één drempel: ruis vraagt meer zekerheid dan
    urgent, want urgent-als-ruis is veel erger dan ruis-als-urgent.
  • Audit-steekproef: 5% van de zekere gevallen gaat alsnog naar de LLM,
    anders ziet niemand de zelfverzekerde fouten.
  • Zonder classifier: nooit stil gokken, altijd naar de LLM.

Bewijs

TDD: eerst rood (ImportError: cannot import name 'growkit_poortwachter'),
daarna groen.

Ran 15 tests in 0.002s
OK

Volledige suite, met en zonder deze wijziging naast elkaar gelegd:

tests resultaat
main (zonder wijziging) 664 66 failures, 89 errors
deze branch 679 dezelfde 66 failures, 89 errors

Die bestaande breuk is omgevingsafhankelijk (GROWKIT_HOST ontbreekt
zonder .env op de VPS) en niet van deze wijziging. In CI staat de variabele
wel ingesteld.

Nog niet gedaan

  • Classifier is een haak, geen model. Geen Laya-gewichten op de VPS.
  • Nog geen eval-set met gelabelde berichten; dat is stap 2.
  • Geen service, geen cron, geen koppeling in de loop — dit is de kern plus tests.

Merge naar main pas na goedkeuring van Tiëndo of KairOS.

…ap 1)

Drie trappen in plaats van twee, naar de review van Claude (1 okt 2026):
regels eerst (gratis), classifier alleen voor vrije tekst van buiten, LLM
bij twijfel.

Harde regels, met de router zelf als handhaver:
- machine-alerts (bron=script) gaan nooit door een probabilistisch filter
- ruis wordt nooit weggegooid, alleen gedegradeerd en append-only gelogd
- drempel per klasse: ruis vraagt meer zekerheid dan urgent
- 5% van de zekere gevallen gaat alsnog naar de LLM (audit-steekproef)
- zonder classifier nooit stil gokken

TDD: 15 tests, eerst rood (ImportError), daarna groen. Volledige suite:
679 tests, dezelfde 66 failures + 89 errors als op main -- die zijn
omgevingsafhankelijk (GROWKIT_HOST/.env ontbreekt op de VPS), niet van
deze wijziging.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant