Skip to content

feat(smoke): optionale Smoke-Station vor MARK_READY (v0.9.0) - #10

Merged
TMogdans merged 2 commits into
mainfrom
feat/smoke-station
Nov 20, 2026
Merged

TMogdans merged 2 commits into
mainfrom
feat/smoke-station

Conversation

@TMogdans

Copy link
Copy Markdown
Collaborator

Optionale Station smoke (v0.9.0): Smoke gegen einen lokalen Stack auf dem PR-Stand, nach einem akzeptierten Critic-Verdikt und vor MARK_READY — nur für Tiers, die das Ziel-Repo per .devloop/config.json smoke.tiers einschaltet. Ohne Eintrag bleibt die Kette unverändert.

Was die Station tut

  1. Konsumenten ermitteln – wer ruft den geänderten Pfad tatsächlich auf (mit datei:zeile).
  2. Modus je Fall daraus ableiten: Browser, API (echte Tokens) oder CLI.
  3. Wirkung messen – Zustand vorher/nachher; ein HTTP-Status allein ist kein Smoke.
  4. Abnahme-Anleitung für den Menschen schreiben; der Stack bleibt für dessen Abnahme laufen. Sie ersetzt die menschliche Abnahme nicht.

Anlass: bsk #421 – ein Klicktest wäre grün gewesen, ohne die Änderung zu berühren, weil die Oberfläche einen anderen Endpunkt benutzt als den geänderten.

Kern

  • Driver, Invariante 8: MARK_READY für eingeschaltete Tiers nur mit abgeleitetem passed/not-applicable.
    • failed → Rückkante.
    • not-run → ein Neustart, dann ESCALATE smoke-not-run.
    • unbekannter Status → ESCALATE smoke-invalid-state.
  • smoke-verdict: Der Status kommt aus der Schema-Validierung des rohen Berichts, nie aus einem Selbst-Label. Als not-run gilt ein Bericht:
    • ohne effect je Fall,
    • ohne Konsumenten-Analyse,
    • ohne Abnahme-Anleitung,
    • mit setup.ok: false,
    • mit mehr als einem Bericht im Text.
  • smoke-tiers: liest die Config; bei kaputter Config Exit 1 statt still „aus“. Loop und Resume nutzen es.
  • specify: Pflichtabschnitt ## Smoke mit belegtem Aufrufer und „Nach dem Deploy“.

Nachweis

  • Tests: 454 grün (vorher 417); check:dist sauber.
  • Mutationen: 16, alle von den Tests erkannt (9 eigene, 7 nach der Critic-Runde).
  • Frischer Critic (nur lesend) hat zuerst abgelehnt. Zwei Major-Befunde, beide nachgemessen und in 6dc3dbf behoben:
    • Resume ohne smokeTiers → MARK_READY am Smoke vorbei.
    • Ein zitiertes grünes Beispiel maskierte einen roten Bericht.

Bekannte Grenzen

  • Nicht maschinell prüfbar: dass effect mehr als ein Status ist, dass not-applicable stimmt, dass der Arbeitsbaum unverändert bleibt.
  • Rote Smoke-Fälle laufen nicht über den Befund-Ledger; die Rückkante begrenzt nur maxIter.
  • Kein Smoke-Ergebnis über Resume: Ein grüner Draft-PR durchläuft Critic und Smoke neu.

Nach einem akzeptierten Critic-Verdikt fährt die isolierte Station `smoke`
für die per `.devloop` `smoke.tiers` eingeschalteten Tiers einen Smoke
gegen einen lokalen Stack auf dem PR-Stand: erst die Konsumenten des
geänderten Pfads mit datei:zeile belegen, daraus Browser/API/CLI wählen,
je Fall die Wirkung vorher/nachher messen. Liefert eine Abnahme-Anleitung
für den Menschen; ersetzt dessen Abnahme nicht.

- Driver (Invariante 8): MARK_READY nur mit abgeleitetem passed oder
  not-applicable; failed -> Rückkante, not-run -> ein Neustart, dann
  ESCALATE smoke-not-run. Ohne smoke.tiers bleibt die Kette unverändert.
- smoke-verdict-CLI: Status aus Schema-Validierung des rohen Berichts,
  nie aus einem Selbst-Label. Ungültig u. a. ohne effect je Fall, ohne
  Konsumenten-Analyse, ohne Abnahme-Anleitung, bei setup.ok false.
- specify: Abschnitt `## Smoke` mit belegtem Aufrufer und "Nach dem Deploy".
- Bekannte Grenze: Smoke-Befunde laufen nicht über den Ledger, die
  Rückkante begrenzt hier nur maxIter.

Anlass: bsk #421 — ein Klicktest wäre grün gewesen, ohne die Änderung zu
berühren, weil die Oberfläche einen anderen Endpunkt benutzt.
- Resume/Loop lesen smokeTiers über die neue CLI smoke-tiers (kaputte
  Config -> Exit 1 statt still aus). Vorher lief ein eingeschaltetes Tier
  nach Resume am Smoke vorbei zu MARK_READY (bei T0/T1 Auto-Merge).
- Mehr als ein Bericht mit cases im Text -> not-run. Vorher gewann das
  erste Objekt: ein zitiertes grünes Beispiel maskierte einen roten Bericht.
- Unbekannter smoke-Status -> ESCALATE smoke-invalid-state.
- Loop-Skill: ready:false bei markDraft, Smoke-Gate am Server-Tier,
  Stack vor RE_GEN abräumen; Station: Infra-Abbruch = setup.ok:false.
- Tests für die vier überlebenden Mutanten (req, Konsument, Fall, expected).
@TMogdans
TMogdans merged commit 7e4d301 into main Nov 20, 2026
1 check passed
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