refactor: safe update engine, durable execution and shared proposal views

Wuast94 commented

2026-09-05 01:32:00 +02:00

Owner

Umfang

Gemeinsamer Rework mit überprüften Zwischencommits. CI, Release-Workflow und Dockerfile bleiben unverändert. Keine produktiven Scans oder Änderungen an bestehenden Update-PRs ausgelöst.

Gemeinsame Identitäts-, Versions- und Entscheidungsdaten einschließlich Strategie, Policy-Herkunft, Lookup-Alter und Kandidaten-Ablehnungsgründen.
Konsistente Nachweise für wiederholte Abhängigkeiten als normales Verhalten ohne Opt-in: Cache-Stand und identische Tag-/Metadaten-/Digest-Abfragen bleiben innerhalb eines Scans stabil. Bestehende automatische Gruppierung und linkedUpdates bleiben erhalten.
Strukturierte Proposal-Transitions für Markdown und UI, zusammengefasste Fundstellen, getrennte Paket-/Chart-/App-Versionen und nachvollziehbare Release-Quellen statt erfundener Vergleichsreferenzen.
Frontend nach Features aufgeteilt; teilbare Repository-/Run-/Dependency-Links mit Browsernavigation und Schutz gegen verspätete Antworten.
Dauerhafte Scan-Anfragen samt Optionen und Phasen, Wiederaufnahme beim Start, PostgreSQL-Repository-Koordination und Commit-/Phasenprüfung vor Schreibzugriffen.
Begrenzte HTTP-/dekomprimierte Antworten, typisierte Fehler, settings-isolierte gemeinsame Lookups, kontrollierte Abbrüche und explizite Cache-Frische.

Versions- und Schreibsicherheit

Die vorhandenen Versionsparser, Vergleicher, Docker-Varianten-/Build-Regeln, Präfixe und Digest-Prüfungen wurden nicht ersetzt. Die zunächst hinzugefügte coupledUpdates-Konfiguration wurde nach Nutzerkorrektur vollständig entfernt. Es gibt weder Opt-in noch eine erzwungene gemeinsame Versionsnummer über unterschiedliche Abhängigkeiten hinweg. Gleiche Auswahlinputs verwenden konsistente Nachweise; ausdrücklich unterschiedliche Versionsregeln, Varianten und Quellen bleiben getrennt. Normale Lockfile-Pflege bleibt unverändert.

Unvollständige Ergebnisse dürfen bestehende PRs nicht schließen. Eine angeforderte normale PR-Gruppe muss alle geplanten Änderungen enthalten; eine unabhängige vollständige Gruppe bleibt schreibbar. Veraltete oder nicht entscheidungsbereite Scans dürfen keine PRs schreiben. Schreibgrenzen einschließlich nach Lockfile-Erzeugung, Push, PR, Automerge und Fehler-Cleanup prüfen die Repository-Ownership erneut. Bereits laufende externe Operationen lassen sich durch PostgreSQL nicht nachträglich fencen; keine Exactly-once-Behauptung.

Migration / Betrieb

Migrationen 018/019 ergänzen Scan-Ausführung und Entscheidungserklärungen. Historische Snapshots bleiben lesbar. Für Schreibaktionen aus alten Datenbank-Scans ohne aufgezeichneten Source-Commit ist ein neuer Scan erforderlich. Fehlgeschlagene PR-Reconciliation bleibt für den nächsten Prozessstart erhalten; keine unendlichen automatischen Retries.

Prüfung

Vollständiges scripts/ci-checks.sh: Format/Lint, Module, Vulnerability-/Dependency-Audits, Deadcode, TypeScript, Biome, Frontend-Verhalten und alle Go-Tests mit Integration, Race-Detector und Shuffle.
Produktionsimage für linux/amd64 gebaut; scripts/ci-smoke-image.sh mit isoliertem PostgreSQL erfolgreich.
Bestehende Versionierungs-Fuzzer zusätzlich ausgeführt; keine Fehler.
Kontrollierte Promises/Channels und Fake-Clock statt zeitabhängiger Beweise; keine Tests auf statische Dateiwerte oder Versionspins.

Plan und technische Nachweise: docs/superpowers/plans/2026-09-05-update-engine-rework.md, docs/update-decisions.md, docs/scan-execution.md, docs/network-evidence.md, docs/update-pull-requests.md.

Datenbank-Optimierung

Commits 08b48b7 / f01d680: unveränderliche Kandidaten-/Release-Evidenz unabhängig dedupliziert; vollständige Versionen, Digests und historische Proposals bleiben erhalten. Kleine Inline-Vorschau statt mehrfacher vollständiger JSON-Kopien.
Automatische 30-Tage-Retention ohne Opt-in; neuester Scan, neuester ausgewerteter Stand und laufende/pending Ausführungen bleiben geschützt. Repository-Locks, begrenzte Transaktionen, faire Zeitbudgets, schrittweise Altbestand-Kompaktierung und begrenzte Evidence-GC.
Migrationen 020/021 sind additiv; keine große Datenumschreibung beim Start. Kein automatisches VACUUM FULL. Rollback erfordert die explizite Rückmigration vor dem alten App-Binary; alte/neue Versionen während dieser Umstellung nicht parallel betreiben.
Vollständige lokale CI-Checks, zusätzlicher Integration-Tag-Lint, linux/amd64-Image und bestehender Runtime-Smoke-Test grün. Verhaltenstests sichern insbesondere CNPG-Tag/Digest/Release-Notes nach Cache-Wechsel, Kompaktierung und Retention sowie den verlustlosen Downgrade ab.
Synthetische 12-Entscheidungen-Fixture: Payload 450.264 → 46.282 Bytes (~89,7 % weniger; ohne Index-/Zeilen-Overhead, keine Produktionsprognose). Produktiv nichts gelöscht oder ausgerollt.

Details: docs/database-storage.md, docs/superpowers/plans/2026-09-06-database-storage.md.

## Umfang Gemeinsamer Rework mit überprüften Zwischencommits. CI, Release-Workflow und Dockerfile bleiben unverändert. Keine produktiven Scans oder Änderungen an bestehenden Update-PRs ausgelöst. - Gemeinsame Identitäts-, Versions- und Entscheidungsdaten einschließlich Strategie, Policy-Herkunft, Lookup-Alter und Kandidaten-Ablehnungsgründen. - Konsistente Nachweise für wiederholte Abhängigkeiten als normales Verhalten ohne Opt-in: Cache-Stand und identische Tag-/Metadaten-/Digest-Abfragen bleiben innerhalb eines Scans stabil. Bestehende automatische Gruppierung und `linkedUpdates` bleiben erhalten. - Strukturierte Proposal-Transitions für Markdown und UI, zusammengefasste Fundstellen, getrennte Paket-/Chart-/App-Versionen und nachvollziehbare Release-Quellen statt erfundener Vergleichsreferenzen. - Frontend nach Features aufgeteilt; teilbare Repository-/Run-/Dependency-Links mit Browsernavigation und Schutz gegen verspätete Antworten. - Dauerhafte Scan-Anfragen samt Optionen und Phasen, Wiederaufnahme beim Start, PostgreSQL-Repository-Koordination und Commit-/Phasenprüfung vor Schreibzugriffen. - Begrenzte HTTP-/dekomprimierte Antworten, typisierte Fehler, settings-isolierte gemeinsame Lookups, kontrollierte Abbrüche und explizite Cache-Frische. ## Versions- und Schreibsicherheit Die vorhandenen Versionsparser, Vergleicher, Docker-Varianten-/Build-Regeln, Präfixe und Digest-Prüfungen wurden nicht ersetzt. Die zunächst hinzugefügte `coupledUpdates`-Konfiguration wurde nach Nutzerkorrektur vollständig entfernt. Es gibt weder Opt-in noch eine erzwungene gemeinsame Versionsnummer über unterschiedliche Abhängigkeiten hinweg. Gleiche Auswahlinputs verwenden konsistente Nachweise; ausdrücklich unterschiedliche Versionsregeln, Varianten und Quellen bleiben getrennt. Normale Lockfile-Pflege bleibt unverändert. Unvollständige Ergebnisse dürfen bestehende PRs nicht schließen. Eine angeforderte normale PR-Gruppe muss alle geplanten Änderungen enthalten; eine unabhängige vollständige Gruppe bleibt schreibbar. Veraltete oder nicht entscheidungsbereite Scans dürfen keine PRs schreiben. Schreibgrenzen einschließlich nach Lockfile-Erzeugung, Push, PR, Automerge und Fehler-Cleanup prüfen die Repository-Ownership erneut. Bereits laufende externe Operationen lassen sich durch PostgreSQL nicht nachträglich fencen; keine Exactly-once-Behauptung. ## Migration / Betrieb Migrationen 018/019 ergänzen Scan-Ausführung und Entscheidungserklärungen. Historische Snapshots bleiben lesbar. Für Schreibaktionen aus alten Datenbank-Scans ohne aufgezeichneten Source-Commit ist ein neuer Scan erforderlich. Fehlgeschlagene PR-Reconciliation bleibt für den nächsten Prozessstart erhalten; keine unendlichen automatischen Retries. ## Prüfung - Vollständiges `scripts/ci-checks.sh`: Format/Lint, Module, Vulnerability-/Dependency-Audits, Deadcode, TypeScript, Biome, Frontend-Verhalten und alle Go-Tests mit Integration, Race-Detector und Shuffle. - Produktionsimage für linux/amd64 gebaut; `scripts/ci-smoke-image.sh` mit isoliertem PostgreSQL erfolgreich. - Bestehende Versionierungs-Fuzzer zusätzlich ausgeführt; keine Fehler. - Kontrollierte Promises/Channels und Fake-Clock statt zeitabhängiger Beweise; keine Tests auf statische Dateiwerte oder Versionspins. Plan und technische Nachweise: `docs/superpowers/plans/2026-09-05-update-engine-rework.md`, `docs/update-decisions.md`, `docs/scan-execution.md`, `docs/network-evidence.md`, `docs/update-pull-requests.md`. ## Datenbank-Optimierung - Commits `08b48b7` / `f01d680`: unveränderliche Kandidaten-/Release-Evidenz unabhängig dedupliziert; vollständige Versionen, Digests und historische Proposals bleiben erhalten. Kleine Inline-Vorschau statt mehrfacher vollständiger JSON-Kopien. - Automatische 30-Tage-Retention ohne Opt-in; neuester Scan, neuester ausgewerteter Stand und laufende/pending Ausführungen bleiben geschützt. Repository-Locks, begrenzte Transaktionen, faire Zeitbudgets, schrittweise Altbestand-Kompaktierung und begrenzte Evidence-GC. - Migrationen 020/021 sind additiv; keine große Datenumschreibung beim Start. Kein automatisches VACUUM FULL. Rollback erfordert die explizite Rückmigration vor dem alten App-Binary; alte/neue Versionen während dieser Umstellung nicht parallel betreiben. - Vollständige lokale CI-Checks, zusätzlicher Integration-Tag-Lint, linux/amd64-Image und bestehender Runtime-Smoke-Test grün. Verhaltenstests sichern insbesondere CNPG-Tag/Digest/Release-Notes nach Cache-Wechsel, Kompaktierung und Retention sowie den verlustlosen Downgrade ab. - Synthetische 12-Entscheidungen-Fixture: Payload 450.264 → 46.282 Bytes (~89,7 % weniger; ohne Index-/Zeilen-Overhead, keine Produktionsprognose). Produktiv nichts gelöscht oder ausgerollt. Details: `docs/database-storage.md`, `docs/superpowers/plans/2026-09-06-database-storage.md`.

Wuast94 added 12 commits

2026-09-05 01:32:00 +02:00

docs: plan behavior-safe update engine rework 5f42fed9a1

refactor: separate web features and API contracts 6208ee67df

fix: bound datasource responses and classify network failures ba1fb93099

feat: add explicit coupled targets and auditable version decisions f4d510cb36

fix: isolate lookup batches by provider settings and cancel failed work 3f38c13187

feat: expose structured proposals and shareable decision views 45719897ef

fix: preserve browser history and clear stale transient views 03c6d1035c

fix: bound source metadata and decompressed package indexes 384bbe5ef6

fix: reject coupled targets that lockfile regeneration cannot guarantee b51403cedb

feat: persist scan intent and guard shared proposal execution bbc8ef7da7