Skip to content

CHANGELOG.md

Latest commit

 

History

History
274 lines (223 loc) · 13.8 KB

CHANGELOG.md

File metadata and controls

274 lines (223 loc) · 13.8 KB
Raw

Changelog

All notable changes to DevWatchdog are documented here. The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

[Unreleased]

[3.3.0] - 2026-04-22

Added

  • cwd-basierte Projekterkennung (G2) — hinter neuem Feature-Flag useCwdProjectDetection (Default: aus). Liest das Arbeitsverzeichnis via proc_pidinfo(PROC_PIDVNODEPATHINFO) und löst es über einen Projekt-Root-Walker (.git, package.json, Cargo.toml, go.mod, pyproject.toml, Podfile, Package.swift) zum korrekten Projektnamen auf (leaf-wins für Monorepos). Behebt die Regressionsgrenze, dass ~/Projects/Archiv/DevWatchdog/ den Marker "Archiv" statt "DevWatchdog" liefert. Wirkt nur im libproc-Pfad. DevProcess hat neue Felder workingDirectory und detectedProject; das bestehende projectName bevorzugt detectedProject, wenn gesetzt. Closes GitLab #35.
  • Signal-basierter Dev-Klassifier (G1) — hinter neuem Feature-Flag useSignalClassifier (Default: aus). Vier orthogonale Heuristiken (Executable-Pfad, cwd, Parent-Prozess, Bundle-Identifier) ersetzen die Wortlisten-Erstklassifikation. Harter Ausschluss für Nicht-Dev-Bundles (z. B. com.slack., com.notion., Browser) wird von einer Dev-Allowlist überschrieben (VSCode, Cursor, iTerm2, Terminal, Warp). .unknown-Urteile fallen zur Wortliste zurück — existierende defaultInclusionPatterns / defaultExcludedApps bleiben unverändert. Wirkt nur im libproc-Pfad. Closes #36.
  • Zwei neue Settings-Toggles unter „Entwickler" für die oben genannten Flags, im gleichen „Experimentell —" Muster wie der libproc-Scanner.
  • 46 neue Unit-/Integrationstests (ProcPIDInfoCwdTests, ProjectRootResolverTests, DevProcessClassifierTests, LibProcSignalClassifierTests). Test-Baseline 335 → 381.
  • libproc-basierter Prozess-Enumerator (opt-in, Feature-Flag) — neuer LibProcProcessEnumerator nutzt proc_listpids + proc_pidinfo direkt und ersetzt den /bin/ps-Subprocess-Pfad, wenn useLibprocEnumerator unter Einstellungen → Entwickler aktiviert ist. Default false; gleiche DevProcess-Ausgabe wie PSParser; identische Filter-Semantik (Inclusion-Patterns, Excluded-Apps, Playwright-Ausnahme, /Applications/-Heuristik). Scan-Dauer wird auf beiden Backends für Vorher/Nachher-Vergleich geloggt. Bekannte MVP-Divergenzen: command ist nur Exec-Pfad (nicht volles argv); CPU% ist kumulativ seit Start (Delta-Sampling deferred). Closes GitLab #34 (G5).

Fixed

  • GitHub-Actions-CI grün auf Xcode 16.2 / Swift 6.0 strict concurrency — drei non-sendable type-Fehler in SystemPressureMonitor.swift wurden durch zwei neue @unchecked Sendable-Wrapper beseitigt: SendableCurrentValueSubject kapselt Combines CurrentValueSubject (nicht formal Sendable in 6.0) und SendableDispatchSource kapselt any DispatchSourceMemoryPressure für den @Sendable-Handler-Closure. Lokal unter Xcode 26 / Swift 6.2 unverändert grün; CI-Runner zieht jetzt auf Xcode 16.4 (war 16.2) für konsistente Swift-6.0-GA-Baseline.
  • Popover bleibt offen, Buttons reagieren nicht (Regression seit v3.2.0, NSStatusItem-Umbau). LSUIElement-App braucht explizites NSApp.activate(ignoringOtherApps: true) bevor das Popover gezeigt wird — sonst kann das Popover-Window nicht key werden, SwiftUI-Buttons (Beenden, Einstellungen, Protokoll, Kill-CTAs) feuern nicht, und .transient-Dismissal bleibt aus. Zusätzlich verhinderte NSHostingView über dem Status-Button durch eigenes Hit-Testing das Toggle-Verhalten; Label-Host ist jetzt eine PassthroughHostingView, die Klicks an den darunter liegenden NSButton durchreicht. Closes GitLab #38.
  • ActionBar ohne Inhalt bei einem einzelnen aktiven Suspect — 16 px leeres Padding + Divider, wenn genau ein aktiver Suspect ohne Zombies/Idle vorlag, weil die CTA-Logik nur bei count > 1 einen Button rendert. Gate prüft jetzt via hasActionBarContent die tatsächlichen CTA-Conditions. Closes #39.
  • Header-Pill abgeschnitten bei hohen CPU-Werten — Popover-Breite 380 → 400 px, Pill + Timestamp-VStack hat minWidth: 90. Closes #40.
  • Swap-Zeile zeigte Compression-Rate — die ↑ x/s-Rate ist ausschließlich Compression-Rate; wird jetzt nur im "Compressed"-Modus gerendert, nicht wenn die Zeile auf "Swap" flippt. Closes #41.

Changed

  • Pause/Fortsetzen jetzt auch für gruppierte Prozesse — ProcessGroupRowView reicht onThrottle/onResume an expandierte Kind-Rows durch. Im bun (4)- Menü stehen damit Pausieren und Fortsetzen zur Verfügung. Closes #42.
  • Panic-Button visuell sekundär — im Header nur noch Bolt-Icon; ab 10+ Targets erscheint der Count als kleines Badge daneben. Tooltip enthält den aktuellen Count. Hotkey ⌘⇧⌥P unverändert. Closes #43.
  • Empty-State kontextsensitiv — Copy unterscheidet jetzt zwischen normal ("Alles sauber"), elevated ("Vorerst sauber") und emergency ("Keine Targets mehr · System-Druck noch hoch, Scanner greift sofort zu"). Behebt den visuellen Widerspruch zwischen pulsierendem Emergency-Banner und grünem "Alles sauber"-Check. Closes #44.
  • Footer: "Log" → "Protokoll" — einheitlich deutsch. SessionLogView-Titel entsprechend angepasst ("Session-Protokoll"). Closes #45.
  • CPU-Farbskala skaliert jetzt mit ncpu — 100 % CPU auf einer 12-Kern- Maschine ist keine Warnfarbe mehr wert; rot ab ≥ 15 % Gesamt-Kapazität, orange ab ≥ 5 %. Gilt für Einzel- und Gruppenzeilen. Closes #46.
  • CI-Infrastruktur modernisiert — .github/workflows/build.yml pinnt jetzt Xcode 16.4 (letzte Stable-16-Serie mit Swift-6.0-GA-Korrekturen) und unterstützt manuelles workflow_dispatch. Neuer Release-Workflow (release.yml) triggert auf v*-Tags, baut Release-Konfiguration, packt .app via ditto als ZIP und erstellt GitHub Release mit CHANGELOG-Auszug + --generate-notes. .gitlab-ci.yml spiegelt Build+Release. Beide Workflows mit minimalen Token- Scopes (contents: read für Build, contents: write für Release) und env-var-Indirection für user-supplied Tag-Inputs (Injection-Schutz).

Security

  • Release-Workflow-Härtung — ${{ inputs.tag }} (workflow_dispatch) wird jetzt über env: in Shell-Variablen gemappt, nie direkt in run:-Blöcke inline-interpoliert. Gleiches Pattern für alle ${{ steps.*.outputs.* }}- Referenzen. Zusätzliche Tag-Format-Validierung (^v[0-9]+\.[0-9]+\.[0-9]+$) verhindert freie-Text-Injection. build.yml bekommt explizites permissions: contents: read (minimal-privilege).

[3.2.0] — 2026-04-21

Triage follow-up release. User-facing UX clarity (why-badges, smart kill split, hardware-aware recommendations), new infrastructure (disk-persisted session log

  • newly-orphaned detection), the Apple-Silicon-correct memory-pressure signal, and a migration off MenuBarExtra to NSStatusItem that finally makes the menu-bar icon refresh without hovering.

Added

  • "Why?" signal badges per suspect row — NEW ORPHAN, ORPHAN, IDLE Nm, ACTIVE N%, LEAK N MB, RULE …, KILL …, EXPIRED, PAUSED. Each badge is a short capsule with a German tooltip explaining the heuristic. Overall KillConfidence (high/medium/low) colors the status dot and row background so a crowded list draws the eye to real zombies first.
  • Smart-split kill buttons — when both idle (≈0 % CPU) and active (≥ 1 % CPU) suspects exist, the popover renders two distinct buttons: "N inaktive beenden" (green, safe) and "N aktive beenden" (red/orange, risky). Kills a running test/build only when you explicitly say so.
  • Hardware-aware settings recommendations — each timing slider carries a live "Standard: X · Empfohlen: Y (für Z GB RAM)" hint scaled from the host's RAM / core count. Per-section reset button for Timing.
  • Disk-persisted session log — every log entry is now streamed to ~/Library/Application Support/DevWatchdog/sessions/YYYY-MM-DD.jsonl. The log hydrates the last 24 h on launch; 14-day rotation keeps disk usage bounded. Insights finally accrues value across restarts.
  • Newly-orphaned detection — PPID history is tracked across scans; a X → 1 transition is classified as newlyOrphaned (high confidence), steady-state PPID == 1 as adoptedByLaunchd (conservative, medium).
  • Memory compressor signal — host_statistics64(HOST_VM_INFO64) fills the gap where vm.swapusage is always zero on Apple Silicon. PressureDeriver now takes max(swapFraction, compressorFraction) so Emergency mode triggers on the real memory signal.

Changed

  • Menu-bar architecture: replaced MenuBarExtra with an NSStatusItem + NSHostingView setup owned by AppDelegate. Fixes FB11857447 — the system menu-bar server now sees @Published updates immediately without requiring a hover or click on the icon. Emergency-state pulse (phaseAnimator), accessibility labels, and the panic hotkey (⌘⇧⌥P) are preserved.
  • UI language unified to German across every surface — previously a mix of German (MenuBar / Emergency) and English (Settings / Rules / About).
  • About window version reads CFBundleShortVersionString at runtime instead of a hardcoded string, so release builds always display correctly.

Fixed

  • Menu-bar icon no longer requires a hover to reflect fresh scan results (FB11857447 / FB12094112). A prior attempt using TimelineView(.periodic) broke xcodebuild test with a 5.5 min IPC hang and was reverted in favor of the NSStatusItem migration above.
  • Swap readout on Apple Silicon showing permanent 0.0 / 0.0 GB — replaced with a Compressor-dominated Speicher row; Swap still surfaces only when the host actually has non-zero swap usage.
  • About tab showing hard-coded v2.0.0 regardless of the shipped build.
  • Various mixed DE/EN UI labels ("General" / "Rules" / "Warn:" / "Kill:") that made the app look half-finished.

Open follow-ups

See GitLab issues #34 (libproc migration), #35 (project detection via PROC_PIDVNODEPATHINFO), #36 (signal-based dev detection), #37 (proper i18n via Localizable.xcstrings). These are the next session's scope.

[3.1.0] — 2026-04-21

First signed release. Builds on v3.0 (Emergency Mode) with a full observability layer: structured logging, kill-reason audit, a weekly Insights summary, dev filter by path, log export, and richer rule match modes.

Added

  • Structured logger (DWLogger) — all SessionLog calls now flow through a level-filtered, category-tagged logger with kind → category mapping.
  • Insights tab — weekly summary of kills, top projects / process types, reclaimed CPU-hours and RSS-MB; 7-day dismissal per card.
  • Dev Filter (inclusionPatterns) — narrow the watch surface to specific path patterns for single-project focus, configured in Settings.
  • Log export — JSON export with 6 secret-flag redactions, via pasteboard or NSSavePanel; entry points from the Session Log view menu.
  • Match modes for rules — rule patterns now support glob, regex, substring, and exact. Migration-safe decoder keeps existing rules working.
  • Kill-reason audit — every kill carries a structured KillTrigger and KillReason (orphan, maxRuntime, emergency-cpu, emergency-rss, manual, rule-override), persisted in the session log for post-hoc review.
  • Process-info hardening (ProcPIDInfo) — Mach-backed PID info fallback with a ps timeout watchdog, minimum-age gate, and PID-reuse guard.

Changed

  • SessionLog.log is now a thin adapter over DWLogger — behaviour preserved, every entry additionally gets a structured category.
  • Rule decoder is migration-safe: legacy rules without matchMode decode as glob (previous behaviour).

Fixed

  • Swift 6 strict-concurrency issue in the kill pipeline (withUnsafeBytes(of:) instead of withUnsafeMutablePointer).
  • PID-reuse window closed: the PID is re-validated against start-time before every kill signal.

Tests

  • +136 new tests across 10 new test files (DWLogger, InclusionPatterns, KillReason, MatchModeMigration, ProcPIDInfo, EmergencyMinAge, PIDReuse, PSFailureCounter, Insights, LogExporter).
  • Total: 288 tests passing, zero Swift 6 warnings, strict-concurrency clean.

Build & Distribution

  • First Developer ID signed release (G3QZ66475M) with the hardened runtime. Notarization is planned for a subsequent release — use right-click → Open or xattr -d com.apple.quarantine on first launch.
  • DMG artifact (DevWatchdog-3.1.0.dmg) shipped as a GitHub Release asset.

Closes internal tracking epic #21 and sub-issues #22–#32 (minus #25, deferred).

[3.0.0] — 2026-04-20 (never tagged — superseded by 3.1.0)

Added

  • Emergency Mode — when 5-minute load average exceeds emergencyLoadFactor × CPU-count, grace periods shrink and maxRuntime thresholds compress until load returns to normal.
  • New per-rule maxCPUPercent and maxRSSMB fields for resource-aware killing. Decoder is migration-safe (old rules decode with 0 defaults).
  • emergencyMinAgeSeconds setting to protect freshly-spawned processes from Emergency-triggered kills.

Closes GitLab epic #2 and sub-issues #3–#14.

[2.1.0] — 2026-04-06

Added

  • CI pipeline on GitLab (macos-15 runner).
  • Process detection for Bun, Deno, and SWC toolchains.
  • Expanded test coverage.

Fixed

  • CI: removed sudo xcode-select (runner uses system Xcode).

[2.0.0] — earlier

  • Orphan-first zombie detection.
  • Process-type-specific kill limits.
  • Smart action bar (Kill Zombies / Kill Suspects with traffic-light colouring).

[1.0.0] — initial release

  • Menu bar app, 30-second scan, basic auto-kill with grace period.