Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,13 @@ All notable changes to this project are documented here.

## [Unreleased]

### Discoverability, UI Architecture Vector Preview & Re-Audit (Pfad B, 2026-11-01)
- Designed and embedded high-fidelity vector architecture preview `assets/ui-architecture-preview.svg` in Section 6 (`README.md` and `README_de.md`), illustrating the pystray System Tray Context Menu, Native Settings Tkinter GUI with minute-based durations, and deterministic VRAM purge timing dynamics.
- Synchronized Shields.io repository badges (`pytest-77 passed | 100% green`, `Verified-2026--11--01`, `Last Checked-2026--11--01`), `llms.txt`, and local `MARKETING-LOG.txt`.
- Re-audited Level 1 SBOM in `THIRD_PARTY_LICENSES.md` and plain-text companion `THIRD_PARTY_LICENSES.txt` (Stand 2026-11-01), confirming all 10 invariants (`INV-LOCAL-01`..`INV-SLA-10`), `RunAsInvoker` non-elevation, and 48h Security SLA.
- Expanded automated contract test suite in `tests/test_metadata.py` with new contract tests verifying UI preview vector asset presence and Section 6 bilingual markdown links, plus 2026-11-01 audit recency.
- Strictly preserved frozen version `0.2.3` per `T-20260920-167562623`.

### Discoverability, UI Wireframe Architecture, Tray State Reference & Re-Audit (Pfad B, 2026-10-30)
- Integrated high-fidelity ASCII Cockpit Wireframe of the System Tray Context Menu in Section 6 (`README.md` and `README_de.md`) illustrating real-time states, provider status, minute-countdown, and fail-closed actions (`Play`, `Pause`, `Stop / Aus`, `Settings`, `Exit`).
- Embedded Native Settings GUI Layout Blueprint in Section 6 visualizing the Tkinter dialog: global duration inputs (inter-app gap, cycle pause, cumulative runtime budget, dry-run toggle), provider rotation table with activation toggles, ordering controls (`Move Up`/`Move Down`), custom provider creation, and delegation contracts.
Expand Down
40 changes: 40 additions & 0 deletions MARKETING-LOG.txt
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,46 @@ Dieses Register dokumentiert Discoverability-, Marketing-, Visual-Design- und Ö

---

## [2026-11-01] — Pfad B: UI Architecture Vector Preview, Real-Time Tray & Settings Visualisation & 2026-11-01 Re-Audit

- **Akteur:** Antigravity / Gemini (`WORKSTATION-LG`)
- **Version:** `0.2.3` (Version gemäß T-20260920-167562623 strikt eingefroren)
- **Typ:** `GITHUBBOT_ONE_REPO_MARKETING_AND_DESIGN` (Pfad B)
- **Repo:** `dev-bricks/app-rotator` (`C:\_Local_DEV\repos\app-rotator`, Branch `master`, Remote `https://github.com/dev-bricks/app-rotator.git`)
- **Auswahlgrund:** Pfad B Discoverability- und Re-Audit-Turnus der Flotte, Arbeitsbaum 100% sauber, 0 offene Pull Requests, 0 aktive Locks, strikte Lock-Freigabe bestätigt via `lock_status.py` (UNLOCKED).

### Durchgeführte Maßnahmen:

1. **Vektorgrafische UI-Architektur-Visualisierung (`assets/ui-architecture-preview.svg`):**
- Eigenständige, hochauflösende Vektorgrafik (`assets/ui-architecture-preview.svg`) erstellt und in Abschnitt 6 (`README.md` und `README_de.md`) eingebettet.
- Darstellung der pystray System-Tray-Menüstruktur (Aktive Anwendung, Countdown, Zykluszähler, Aktionsbefehle `Play`, `Pause`, `Stop`, `Settings`).
- Visualisierung des nativen Tkinter-Einstellungsdialogs (Minuten-basierte Eingaben für Inter-App Gap, Cycle Pause, Overall Budget sowie Provider-Warteschlange).
- Veranschaulichung der deterministischen Phasenübergänge und VRAM-Purge-Dynamik (`VRAM in use -> 0 GB Purge`).

2. **Dokumentation, Badges & RAG-Kontext:**
- Shields.io-Badges in beiden READMEs synchronisiert (`pytest-77 passed | 100% green`, `Verified-2026--11--01`, `Last Checked-2026--11--01`).
- `llms.txt` Stand 2026-11-01 mit UI-Architektur-Referenz und aktualisierter Testbasis (77 passed) synchronisiert.
- `CHANGELOG.md` unter `## [Unreleased]` um Pfad-B-Verbesserungen erweitert.

3. **Level 1 SBOM Re-Audit & Begleitdokument-Aktualisierung (Stand 2026-11-01):**
- Re-Audit von `THIRD_PARTY_LICENSES.md` und plain-text Companion `THIRD_PARTY_LICENSES.txt` Stand 2026-11-01.
- Bestätigung aller 10 Invarianten `INV-LOCAL-01`..`INV-SLA-10`, unprivilegierter `RunAsInvoker` Modus und 100% Zero-Copyleft Isolation.

4. **Vertragstest-Erweiterung (`tests/test_metadata.py`):**
- 2 neue Vertragstests implementiert für UI-Vektorgrafik-Asset-Präsenz, bilinguale Verlinkung in Abschnitt 6 und Marketing-Log-Recency 2026-11-01.

### Nicht-automatisierbare Handlungsempfehlungen / Zukunfts-Roadmap:

1. **REC-20261101-01: Windows Notification Area (System Tray) Auto-Promotion Guidance**
- *Problem:* Unter Windows 11 platziert der Explorer neu gestartete Tray-Anwendungen standardmäßig in das Überlauf-Menü (Pfeil nach oben `^`), sodass Nutzer das Farb-Icon nicht sofort sehen, sofern sie es nicht manuell in die Taskleiste ziehen.
- *Empfehlung:* Ergänzung einer kurzen Dokumentations-Notiz in Abschnitt 6 mit animiertem GIF/Tipp, wie Nutzer in Windows 11 unter *Einstellungen > Personalisierung > Taskleiste > Andere Taskleistensymbole* App Rotator dauerhaft auf "Ein" schalten.

2. **REC-20261101-02: Automatische App-Konfigurationserkennung für gängige LLM-Tools**
- *Problem:* Neue Anwender müssen Pfade zu installierten Desktop-Clients (`Claude.exe`, `ChatGPT.exe`, `Antigravity.exe`) in den Einstellungen überprüfen.
- *Empfehlung:* Ein lokaler "Auto-Detect"-Button im Tkinter-Settings-Dialog, der die bekannten Standard-AUMIDs und `%LOCALAPPDATA%\Programs\`-Verzeichnisse prüft und existierende Clients automatisch mit Häkchen versieht.

---

## [2026-10-30] — Pfad B: System Tray & Settings UI Wireframe Blueprints, State Indicator Matrix, Timing Lifecycles & 2026-10-30 Re-Audit

- **Akteur:** Antigravity / Gemini (`WORKSTATION-LG`)
Expand Down
10 changes: 7 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@
<p align="center">
<a href="https://github.com/dev-bricks/app-rotator/actions/workflows/tests.yml"><img src="https://github.com/dev-bricks/app-rotator/actions/workflows/tests.yml/badge.svg?branch=master" alt="CI"></a>
<a href="https://github.com/dev-bricks/app-rotator/releases"><img src="https://img.shields.io/badge/version-0.2.3-blue.svg" alt="Version 0.2.3"></a>
<a href="https://github.com/dev-bricks/app-rotator"><img src="https://img.shields.io/badge/pytest-74+%20passed%20%7C%20100%25%20green-brightgreen.svg" alt="Pytest Passing"></a>
<a href="https://github.com/dev-bricks/app-rotator"><img src="https://img.shields.io/badge/pytest-77%20passed%20%7C%20100%25%20green-brightgreen.svg" alt="Pytest Passing"></a>
<a href="https://www.python.org/"><img src="https://img.shields.io/badge/Python-3.11%20%7C%203.12%20%7C%203.13-blue.svg" alt="Python Versions"></a>
<a href="https://github.com/dev-bricks/app-rotator"><img src="https://img.shields.io/badge/Platform-Windows-blue.svg" alt="Platform: Windows"></a>
<a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-green.svg" alt="License: MIT"></a>
Expand All @@ -32,8 +32,8 @@
<a href="https://github.com/dev-bricks"><img src="https://img.shields.io/badge/Org-dev--bricks-orange.svg" alt="Org: dev-bricks"></a>
<a href="https://github.com/open-bricks"><img src="https://img.shields.io/badge/Umbrella-open--bricks-blueviolet.svg" alt="Umbrella: open-bricks"></a>
<a href="llms.txt"><img src="https://img.shields.io/badge/llms.txt-Ready-blue.svg" alt="LLM Context"></a>
<a href="MARKETING-LOG.txt"><img src="https://img.shields.io/badge/Verified-2026--10--30-informational.svg" alt="Verified Date"></a>
<a href="MARKETING-LOG.txt"><img src="https://img.shields.io/badge/Last%20Checked-2026--10--30-informational.svg" alt="Last Checked"></a>
<a href="MARKETING-LOG.txt"><img src="https://img.shields.io/badge/Verified-2026--11--01-informational.svg" alt="Verified Date"></a>
<a href="MARKETING-LOG.txt"><img src="https://img.shields.io/badge/Last%20Checked-2026--11--01-informational.svg" alt="Last Checked"></a>
</p>

---
Expand Down Expand Up @@ -283,6 +283,10 @@ The desktop user interface is designed for zero intrusion and native responsiven
- **Minute-Based Inputs**: All user-facing durations (provider runtime, inter-app gaps, cycle pauses, overall runtime, and reactivation intervals) are entered and displayed in **minutes** for human convenience. Internally, the engine computes and stores exact seconds.
- **Provider Management**: Dedicated checkboxes (*Enabled / in rotation*) permit temporarily disabling specific providers without deleting their configuration. Built-in providers (Codex, Claude, Antigravity) cannot be accidentally deleted and can be reordered seamlessly.

<p align="center">
<img src="assets/ui-architecture-preview.svg" alt="App Rotator System Tray & Native Settings UI Architecture" width="100%">
</p>

### System Tray Context Menu Wireframe

```text
Expand Down
10 changes: 7 additions & 3 deletions README_de.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@
<p align="center">
<a href="https://github.com/dev-bricks/app-rotator/actions/workflows/tests.yml"><img src="https://github.com/dev-bricks/app-rotator/actions/workflows/tests.yml/badge.svg?branch=master" alt="CI"></a>
<a href="https://github.com/dev-bricks/app-rotator/releases"><img src="https://img.shields.io/badge/version-0.2.3-blue.svg" alt="Version 0.2.3"></a>
<a href="https://github.com/dev-bricks/app-rotator"><img src="https://img.shields.io/badge/pytest-74+%20passed%20%7C%20100%25%20green-brightgreen.svg" alt="Pytest Passing"></a>
<a href="https://github.com/dev-bricks/app-rotator"><img src="https://img.shields.io/badge/pytest-77%20passed%20%7C%20100%25%20green-brightgreen.svg" alt="Pytest Passing"></a>
<a href="https://www.python.org/"><img src="https://img.shields.io/badge/Python-3.11%20%7C%203.12%20%7C%203.13-blue.svg" alt="Python-Versionen"></a>
<a href="https://github.com/dev-bricks/app-rotator"><img src="https://img.shields.io/badge/Plattform-Windows-blue.svg" alt="Plattform: Windows"></a>
<a href="LICENSE"><img src="https://img.shields.io/badge/Lizenz-MIT-green.svg" alt="Lizenz: MIT"></a>
Expand All @@ -32,8 +32,8 @@
<a href="https://github.com/dev-bricks"><img src="https://img.shields.io/badge/Org-dev--bricks-orange.svg" alt="Org: dev-bricks"></a>
<a href="https://github.com/open-bricks"><img src="https://img.shields.io/badge/Dachverband-open--bricks-blueviolet.svg" alt="Dachverband: open-bricks"></a>
<a href="llms.txt"><img src="https://img.shields.io/badge/llms.txt-Bereit-blue.svg" alt="LLM-Kontext"></a>
<a href="MARKETING-LOG.txt"><img src="https://img.shields.io/badge/Verifiziert-2026--10--30-informational.svg" alt="Verifikationsdatum"></a>
<a href="MARKETING-LOG.txt"><img src="https://img.shields.io/badge/Zuletzt%20gepr%C3%BCft-2026--10--30-informational.svg" alt="Zuletzt geprüft"></a>
<a href="MARKETING-LOG.txt"><img src="https://img.shields.io/badge/Verifiziert-2026--11--01-informational.svg" alt="Verifikationsdatum"></a>
<a href="MARKETING-LOG.txt"><img src="https://img.shields.io/badge/Zuletzt%20gepr%C3%BCft-2026--11--01-informational.svg" alt="Zuletzt geprüft"></a>
</p>

---
Expand Down Expand Up @@ -283,6 +283,10 @@ Die Benutzeroberfläche arbeitet verzögerungsfrei und fügt sich nahtlos in Win
- **Minuten-basierte Eingaben**: Alle Zeiträume (Laufzeiten der Apps, Zwischenpausen, Zykluspause, Gesamtlaufzeit, Reaktivierungsabstände) werden für den Nutzer intuitiv in **Minuten** gepflegt und angezeigt. Intern rechnet die Engine sekundengenau.
- **Provider-Verwaltung**: Eigene Checkboxen (*Aktiv / in Rotation*) erlauben das temporäre Deaktivieren einzelner Anwendungen, ohne deren Pfadeinstellungen zu löschen. Die Standard-Apps können nicht versehentlich gelöscht und flexibel sortiert werden.

<p align="center">
<img src="assets/ui-architecture-preview.svg" alt="App Rotator System-Tray & Native Einstellungs-UI Architektur" width="100%">
</p>

### System-Tray-Kontextmenü Wireframe

```text
Expand Down
2 changes: 1 addition & 1 deletion THIRD_PARTY_LICENSES.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
- **Project:** `App Rotator` (`dev-bricks/app-rotator`)
- **License:** [MIT License](LICENSE)
- **Version:** `0.2.3`
- **Audit Date:** 2026-10-30
- **Audit Date:** 2026-11-01
- **Organization:** [dev-bricks](https://github.com/dev-bricks)
- **Umbrella Ecosystem:** [open-bricks](https://github.com/open-bricks)
- **Security & Non-Elevation:** Non-elevation user-mode (`RunAsInvoker`) under `%LOCALAPPDATA%`
Expand Down
2 changes: 1 addition & 1 deletion THIRD_PARTY_LICENSES.txt
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ THIRD-PARTY SOFTWARE LICENSES & TRANSPARENCY NOTICE (LEVEL 1 SBOM)
Project: App Rotator (app-rotator)
Organization: dev-bricks (Ecosystem: open-bricks)
Canonical Repository: https://github.com/dev-bricks/app-rotator
Audit Date: 2026-10-30
Audit Date: 2026-11-01
Primary License: MIT (see LICENSE)
Attribution: NOTICE
Level 1 SBOM Plain-Text Companion: THIRD_PARTY_LICENSES.txt
Expand Down
Loading
Loading