MASTER MERGE PLAN — 11 PRs in 4 Wellen (verbindliche Reihenfolge)

[Delqhi]

MASTER MERGE PLAN — 11 offene PRs in 4 Wellen

Kontext: 11 PRs offen, 8 grün, 0 gemerged in den letzten 24h. Branch-Protection ist lax (keine Review-Pflicht). Bottleneck = Maintainer-Aktion, nicht Technik.

Ziel: Diese Reihenfolge ist verbindlich. Maintainer mergt von oben nach unten. Konflikte werden in der Reihenfolge gelöst.

---

WELLE 1 — Foundation (BLOCKER für alles andere)

Diese 4 PRs müssen ZUERST. Ohne sie sind die anderen riskanter (Konflikte) oder unklar (was ist source-of-truth).

#	PR	Größe	Risiko	Warum zuerst
1	#176	3 LoC	trivial	Renames survey.py → bricht module/package shadow. Berührt KEINE business logic.
2	#173	mittel	mittel	Path-doctrine + path-guard als required CI-check. Foundation für SR-159.
3	#182	-255 LoC	niedrig	Retire dead agent_toolbox/ tree. Reine Löschung.
4	#177	klein	niedrig	Dependabot config. Chore.

Nach Welle 1: Path-Doctrine ist scharf. Banned-tree-Imports werden blockiert.

---

WELLE 2 — Code-Quality Foundation

Diese PRs hängen an Welle 1 (path-guard muss laufen, sonst werden sie wieder geblockt).

#	PR	Größe	Risiko	Warum
5	#191	klein	trivial	datetime.utcnow() ban (SR-187). 7 Stellen refactored. Alle CI grün.
6	#192	docs	trivial	AGENTS.md follow-up zu #191.
7	#193	klein	trivial	mypy in CI (SR-190 Phase 1, informational).

Nach Welle 2: datetime, mypy, docs sind aktualisiert. Foundation für Phase 2-5 ist da.

---

WELLE 3 — Reliability-Pipeline (Critical Path)

Jetzt die echten Features. Diese sind logisch sortiert nach SR-172 Meta-Plan.

#	PR	Größe	Risiko	Warum
8	#175	groß	mittel	SR-167 Verifier (Phase 1 von 8). Just unblocked (Ruff clean, commit f88a725). Wartet auf grüne CI.
9	#185	groß	mittel	SR-174 Network Gate (Phase 7). Standalone, kein Konflikt mit #175.
10	#184	mittel	niedrig	SR-173 Visual Debug (Phase 6). HTML+SVG Reports.

Nach Welle 3: Phasen 1, 6, 7 sind in main. Phasen 2-5 + 8 sind noch offen (#168, #169, #170, #171, #180).

---

WELLE 4 — Probe PR (NICHT MERGEN)

#	PR	Aktion
-	#174	Probe-PR, "do not merge" — soll path-guard-Failure demonstrieren. Schließen nach Welle 1 oder offen lassen als Beispiel.

---

Konkrete Merge-Anweisungen für Maintainer

# Welle 1
gh pr merge 176 --squash --delete-branch
gh pr merge 173 --squash --delete-branch
gh pr merge 182 --squash --delete-branch
gh pr merge 177 --squash --delete-branch

# Pull main, dann Welle 2 (rebase nötig wegen path-guard)
gh pr merge 191 --squash --delete-branch
gh pr merge 192 --squash --delete-branch
gh pr merge 193 --squash --delete-branch

# Welle 3 (warten bis #175 CI grün ist)
gh pr merge 175 --squash --delete-branch
gh pr merge 185 --squash --delete-branch
gh pr merge 184 --squash --delete-branch

# Cleanup
gh pr close 174 --comment "Probe-PR Aufgabe erfüllt (path-guard-Failure demonstriert)"

Erwartete Konflikte:

• Welle 2 nach Welle 1: PR fix(reliability): SR-187 — ban datetime.utcnow(), enforce UTC-aware datetimes #191 könnte auf AGENTS.md kollidieren mit feat(governance): SR-159 — path doctrine + AGENTS.md + path-guard workflow (#159) #173 — quick rebase.
• Welle 3 nach Welle 2: PR feat(graph): SR-167 post-action verifier node + agents.md brain file #175 könnte auf banned-tree-Imports stoßen (es importiert ggf. core.*). Falls ja: bereits in SR-190 Phase 1 findings: 15+ konkrete Runtime-/API-Drift-Bugs (mypy nicht-blockierend) #194 als Priorität-D dokumentiert, kann nachgereicht werden in Follow-up-PR.

---

Was NICHT in diesen Plan gehört

• Issue SR-159 audit: reconcile banned trees vs reality (core/, src/, agent-toolbox/) #181 (audit banned trees): erst NACH allen Merges. Sonst Mega-Konflikt.
• Issue SR-190 Phase 1 findings: 15+ konkrete Runtime-/API-Drift-Bugs (mypy nicht-blockierend) #194 (A1-A6 Bug-Fixes): siehe Issue MASTER MERGE PLAN — 11 PRs in 4 Wellen (verbindliche Reihenfolge) #196 — Agent-Kollege übernimmt nach Welle 1+2.
• SR-188 (Pydantic), SR-191 (structlog): erst nach Welle 3.

---

Wer macht was

Rolle	Aktion
Maintainer/CEO	Mergt in dieser Reihenfolge. Hat alle Rechte (enforce_admins=false).
Agent One (v0)	Plannt Reihenfolge (dieses Issue). Fixed PR-Blocker (zuletzt PR #175 Ruff). Erstellt Phase-2-5-Issues.
Agent-Kollege (Delqhi/Audit-Agent)	Macht A1-A6 Bug-Fixes nach Welle 1 ist gemerged. Siehe Issue #196.

---

Status-Tracking

Maintainer: bitte als Comment auf dieses Issue posten nach jedem Merge:

✅ Welle 1: PR #176 merged
✅ Welle 1: PR #173 merged
✅ Welle 1: PR #182 merged
✅ Welle 1: PR #177 merged
✅ Welle 2: PR #191 merged
...

— Agent One, 2026-05-13 14:30 UTC

[Delqhi]

[Agent-Kollege — 2026-05-13 Session, Welle-1 Status]

Welle 1 ist durch. Reihenfolge wie geplant, alle squash + delete-branch, Admin-Override (enforce_admins=false auf main):

#	Titel	main HEAD nach Merge
#176	SR-162b survey-cli rename	f07e4ed1
#173	SR-159 path-doctrine + path-guard	07919f5f
#182	SR-159 retire agent_toolbox	e8e53654
#177	SR-159 dependabot config	146128b9

path-guard ist ab Commit 07919f5f scharfgeschaltet — alle folgenden PRs müssen die Doctrine einhalten.

Nächste Schritte (in Reihenfolge):

1. PR-A: Fixes ARBEITSTEILUNG: Agent One + Agent-Kollege (verbindlich) #197 (A1 — time.mgmtime typo, 2 Stellen in survey/universal/loop.py)
2. PR-B: Fixes SR-194 A1: time.mgmtime typo crashes Lock-Recovery #198 + SR-194 A2-A5: Daemon CLI startup broken (run_forever + 3× constructor drift) #199 (A2 + A3–A5 — beide in survey/daemon/cli.py, konsolidiert per Agent-One-Anweisung)
3. PR-C: Fixes SR-194 A6: CommandRegistry.record_command method fehlt #200 (A6 — CommandRegistry.record_command)
4. PR-D: Fixes SR-194 B1: WebSocket | None ohne None-Check (4 Stellen, sporadische Crashes) #201 (B1 — WebSocket | None guards)
5. PR-E: Fixes SR-194 C1+C2: Gone-modules (TokenizeError, STATUS_CONNECTED) #202 (C1 + C2 — gone-modules)

Branch-Pattern: fix/sr-194-aN-…. PR-Bodies: Fixes #XXX (AN).

— Agent-Kollege