Skip to content

Commit 1b0ab4e

Browse files
Toqsickclaude
andauthored
docs: Wiki-/README-Sync nach den MLA-Merges (#60/#93/#111) (#113)
* docs: Wiki-/README-Sync nach den MLA-Merges (#60/#93/#111) - README: Fork-URLs (Toqsick/master-linux-assistant); features.csv/MANIFEST.md repo-lokal referenziert statt Upstream-Blob-Links - Architecture.md: la_core-Paket im Baum + Modul-Registry (#60) ersetzt die alte Screen-Tool-Switch-Prozedur - Release-Process.md: la_core-Gates + la_probe-Headless-Compile in build-deb.sh - Testing.md: 3 neue Testdateien (Hub-Registry/Navigation/Spawn-Runner); 208 Flutter-Tests / 53 Python / 61 la_core (Stand main) Co-Authored-By: Claude Code <noreply@anthropic.com> * docs: la_core-Testzahl auf 68 nach #110-A/#110-B nachziehen Co-Authored-By: Claude Code <noreply@anthropic.com> --------- Co-authored-by: Claude Code <noreply@anthropic.com>
1 parent 0ca532b commit 1b0ab4e

4 files changed

Lines changed: 29 additions & 15 deletions

File tree

‎README.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -84,8 +84,8 @@ trigger is `Color.withValues(alpha:)` in the Hermes widgets), check
8484
`flutter --version` and switch to a newer channel if needed.
8585

8686
```bash
87-
git clone https://github.com/Jean28518/linux-assistant.git
88-
cd linux-assistant
87+
git clone https://github.com/Toqsick/master-linux-assistant.git
88+
cd master-linux-assistant
8989

9090
# Option 1: Build with flutter manually
9191
flutter build linux
@@ -171,7 +171,7 @@ flatpak run io.github.jean28518.Linux-Assistant
171171

172172
## Features
173173

174-
<https://github.com/Jean28518/linux-assistant/blob/main/features.csv>
174+
`features.csv` im Repo-Root (distro/desktop support matrix)
175175

176176
## Current Languages
177177

@@ -182,7 +182,7 @@ flatpak run io.github.jean28518.Linux-Assistant
182182

183183
## Mission
184184

185-
<https://github.com/Jean28518/linux-assistant/blob/main/MANIFEST.md>
185+
`MANIFEST.md` im Repo-Root
186186

187187
## Development
188188

‎docs/wiki/Architecture.md‎

Lines changed: 10 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,9 @@ lib/
2525
├── widgets/hermes/ Hermes-Widgets (Card, StatTile, Sparkline,
2626
│ Badge, HaloDot, NavItem, CopyCommand)
2727
├── models/, enums/, content/, helpers/, l10n/
28+
├── packages/ la_core: Flutter-freier Dart-Kern (#59/#60/#93)
29+
│ Parser, Probe-Vertrag, ModuleRegistry, EventBus,
30+
│ CommandRunner, la_probe (headless CLI)
2831
additional/python/ Helferskripte (Umgebung, Apps, Bookmarks, …)
2932
```
3033

@@ -49,14 +52,14 @@ Content-Fläche.
4952
`fileManager`, `systemMonitor` → rendern im Frame, getrackt in
5053
`_screenTool`).
5154

52-
### Screen-Tool-Pattern (neues Werkzeug hinzufügen)
55+
### Modul-Registry (Werkzeug hinzufügen, Issue #60)
5356

54-
Vier kleine Edits in `hub_shell.dart`:
55-
56-
1. Wert in `enum HubTool` aufnehmen
57-
2. Case in `_iconOfTool` + `_titleOfTool`
58-
3. Case in `_onToolTap` (Screen → `_selectTool`, extern → Launch)
59-
4. Case in `_contentFor` (Screen-Widget zurückgeben)
57+
Ein Eintrag in der `hubModules`-Map in `hub_module.dart` ersetzt die
58+
ehemaligen `switch`-Blöcke: Wert in `enum HubSection`/`HubTool` aufnehmen und
59+
ein zugehöriges `HubModule` registrieren (Icon, Titel, `screenBuilder`,
60+
Starts-Prozess-Flag). `hubModuleOf(tool)` ist der einzige Reader und wirft
61+
laut, wenn ein Enum-Wert ohne Registry-Eintrag bleibt; `hub_shell.dart`
62+
iteriert die Enums und rendert die Sidebar aus der Registry.
6063

6164
## Stats-Polling (Performance)
6265

‎docs/wiki/Release-Process.md‎

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -33,8 +33,12 @@ bash ./build-deb.sh # linux-assistant_0.7.2_amd64.deb (+ Alias linux-assistant
3333
## Packaging-Details
3434

3535
- **deb:** `build-deb.sh` staged in `build/deb-root/` (schreibt nichts mehr
36-
in getrackte Dateien), deklariert GTK + Python-Module + keybinder.
37-
Install: `sudo apt install ./linux-assistant_*_amd64.deb`.
36+
in getrackte Dateien), deklariert GTK + Python-Module + keybinder. Es
37+
kompiliert außerdem den headless-Probe `la_probe` aus
38+
`packages/la_core/bin/la_probe.dart` nach
39+
`/usr/lib/linux-assistant/la_probe` und smoked ihn display-los
40+
(`--version`); fehlt `dart` im PATH, wird der Schritt übersprungen (kein
41+
Paketfehler). Install: `sudo apt install ./linux-assistant_*_amd64.deb`.
3842
- **rpm:** unmaintained (`packaging/unmaintained/build-rpm.sh`, Version-Ersetzung per Feldname).
3943
- **arch:** unmaintained (`build-arch-pkg.sh` bricht ab, solange kein `PKGBUILD`
4044
neben dem Skript liegt; siehe `packaging/unmaintained/`).
@@ -51,7 +55,9 @@ Binaries tragen die glibc des Build-Images – ein stiller Wechsel von
5155
(Zorin OS 18, Mint 22, Ubuntu 24.04) nicht starten.
5256

5357
Reihenfolge: `flutter pub get` → `tool/check-versions.sh` → `dart format`-Gate
54-
→ `flutter analyze`-Gate → `flutter test` → Python-Unit-Tests → `build-deb.sh`
58+
→ `flutter analyze`-Gate → `flutter test` → Python-Unit-Tests → la_core-Gates
59+
(`dart pub get` → `dart analyze` → `dart format` → `dart test` →
60+
`la_probe`-Headless-Compile in `packages/la_core`) → `build-deb.sh`
5561
→ Artefakt-Upload.
5662

5763
## In-App-Updater

‎docs/wiki/Testing.md‎

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,8 +19,13 @@
1919
| `l10n_test.dart` | l10n-Vollständigkeit der `.arb`-Dateien | Unit |
2020
| `quick_notes_widget_test.dart` | E2 QuickNotes-Widget (Save-Race, Fehler-State) | Widget-Tests |
2121
| `security_check_outcome_test.dart` | `classifySecurityCheck` (Exit-Code-Deutung) | Unit |
22+
| `hub_module_registry_test.dart` | `hubModules`-Registry (#60): Bijektion, Widget-Bau, ARB-Titel | Pure Dart |
23+
| `hub_navigation_test.dart` | Hub-Shell-Navigation H1–H9 (#60, Characterization) | Widget-Tests |
24+
| `process_command_runner_test.dart` | `ProcessCommandRunner`: echte Prozesse, pkexec/flatpak-Präfixe | Spawn-Tests |
2225

23-
Ausführen: `flutter test` (aktuell: 177 Tests in 15 Dateien).
26+
Ausführen: `flutter test` (aktuell: 18 Dateien, 208 Tests; Python-Suite:
27+
`additional/python` → 53 Tests, `packages/la_core` → 68 Dart-Tests mit
28+
eigenen `dart analyze`/`dart format`-Gates).
2429

2530
## Etablierte Patterns
2631

0 commit comments

Comments
 (0)