hmgr 0.0.7 → 0.0.12

package/dist/gui/renderer/styles.css

@@ -154,16 +154,34 @@ a{color:var(--signal-tief)}
 .stand{margin:22px 4px 0;padding:14px 6px 0;border-top:1px solid rgba(255,255,255,.16);display:flex;flex-wrap:wrap;gap:10px 12px;align-items:center}
 .stand p{flex:1 1 130px;font-size:16px;line-height:1.4;color:var(--emaille-hell)}
 .stand p b{font-weight:600;color:#F1F6EF}
-/* Ruhig, solange nichts ansteht; erst „mit Neuem" (.neu) macht ihn zum Signal. Der Knopf ist
-   zugleich der Weg in die Update-Ansicht, deshalb nie disabled. */
+/* Ruhig, solange nichts ansteht; erst „mit Neuem" (.neu) macht ihn zum Signal. Der Knopf öffnet
+   nur die Ansicht (E80), deshalb nie disabled. Schmaler als vorher: er trägt jetzt nur noch „›". */
 .standknopf{
   background:transparent;border:1px solid rgba(255,255,255,.3);color:var(--emaille-hell);border-radius:3px;
-  padding:6px 13px;cursor:pointer;white-space:nowrap;font-family:var(--schrift);font-weight:500;
-  font-size:16px;letter-spacing:-.005em;transition:background .14s ease,border-color .14s ease,color .14s ease;
+  padding:6px 13px;min-width:34px;text-align:center;cursor:pointer;white-space:nowrap;
+  font-family:var(--schrift);font-weight:500;font-size:16px;letter-spacing:-.005em;
+  transition:background .14s ease,border-color .14s ease,color .14s ease;
 }
 .standknopf:hover{background:var(--emaille-hoch);color:#F1F6EF}
 .standknopf.neu{border-color:var(--emaille-hell);background:var(--emaille-hoch);color:#F1F6EF;font-weight:600}
 
+/* Update-Hinweis über hmgr selbst (E77), direkt über dem Einstellungen-Knopf. Dezent wie die
+   Stand-Zeile darüber: kleiner, in der hellen Emaille-Farbe, ohne Signalton — es ist eine Ansage,
+   keine Aufforderung. Der Befehl darin steht im Monospace und darf umbrechen, er ist lang.
+   Das `margin-top:auto` wandert zu ihm, solange er steht: sonst schöbe der Knopf ihn nach oben
+   von sich weg, statt dass beide zusammen unten sitzen. */
+.selbstupdate{margin-top:auto;padding:14px 6px 0;display:flex;flex-direction:column;gap:6px}
+/* Neustart-Knopf (E80): unter der GUI-Zeile, nicht über die volle Leistenbreite gestreckt (sonst
+   erbte er die Spaltenbreite der Flex-Column). Kein „.neu": er soll nicht wie der Standknopf-Signal
+   aussehen, er meldet nur eine Handlung, keinen Zustand. */
+.selbstupdate .standknopf{align-self:flex-start;min-width:0}
+/* Wie bei .zeile und .wahlzeile: die Klasse setzt display, also braucht hidden eine eigene Regel —
+   sonst stünde der leere Kasten samt seinem auto-Rand da, obwohl nichts zu melden ist. */
+.selbstupdate[hidden]{display:none}
+.selbstupdate p{font-size:15px;line-height:1.45;color:var(--emaille-hell)}
+.selbstupdate code{font-family:var(--mono);font-size:14px;color:#F1F6EF;word-break:break-all}
+
+.selbstupdate:not([hidden]) + .einstellungen{margin-top:0}
 .einstellungen{
   margin-top:auto;padding:14px 6px 0;display:flex;align-items:center;gap:11px;width:100%;
   background:transparent;border:0;border-top:1px solid rgba(255,255,255,.16);cursor:pointer;text-align:left;
@@ -213,6 +231,9 @@ a{color:var(--signal-tief)}
 .chip[aria-pressed="true"]{background:var(--tinte);border-color:var(--tinte);color:var(--blech)}
 /* Harness-Zeichen im Chip (E53 Pkt. 1): kleiner als die Standardgröße, gap übernimmt den Abstand. */
 .chip .hsymbol{width:15px;height:15px;margin-right:0}
+/* Sortierrichtung im Chip (E81): nur der aktive Chip füllt den Pfeil, Farbe erbt über currentColor
+   (im gedrückten Chip also --blech), gap übernimmt den Abstand zum Text. */
+.chip .sortpfeil:empty{display:none}
 
 .katalogzahl{margin:0 0 12px;font-size:16px;color:var(--tinte-weich)}
 .zeilen{display:flex;flex-direction:column;gap:8px;list-style:none;margin:0;padding:0}
@@ -298,6 +319,24 @@ a{color:var(--signal-tief)}
 .knopf[disabled]:hover{background:var(--tinte);border-color:var(--tinte)}
 .knopf.klein{padding:4px 13px}
 
+/* Prüfen-Kringel in der Update-Ansicht (E80): rund statt der früheren großen Signal-Fläche, denn er
+   ist ein Anstoß, keine gefährliche Handlung. Dreht sich, solange der Lauf läuft (.laeuft). */
+.kringel{
+  width:44px;height:44px;border-radius:50%;flex:none;
+  border:1.5px solid var(--tinte);background:var(--tinte);color:var(--blech);
+  font-size:22px;line-height:1;display:flex;align-items:center;justify-content:center;
+  cursor:pointer;transition:background .14s ease,border-color .14s ease,color .14s ease;
+}
+.kringel:hover{background:var(--emaille);border-color:var(--emaille)}
+.kringel:disabled{opacity:.55;cursor:default}
+.kringel.laeuft{animation:kringel-drehen 1s linear infinite}
+@keyframes kringel-drehen{to{transform:rotate(360deg)}}
+@media (prefers-reduced-motion:reduce){
+  /* Die globale Regel weiter unten kappt schon jede Animationsdauer; hier zusätzlich statisch
+     gedämpft statt gedreht, damit der laufende Zustand ohne Bewegung sichtbar bleibt. */
+  .kringel.laeuft{animation:none;opacity:.6}
+}
+
 .ziele{display:flex;flex-direction:column;gap:18px}
 .ziel{background:var(--blech);border:1px solid var(--strich);border-radius:3px;overflow:hidden}
 /* Kopfzeile als Akkordeon-Umschalter (E45): role="button", die ganze Zeile ist klickbar. */
@@ -309,7 +348,10 @@ a{color:var(--signal-tief)}
 .zielkopf .zahl{margin-left:auto;font-family:var(--mono);font-size:16px;color:var(--emaille-zahl)}
 /* Zeichen statt Text-Badge (E45-Nachschärfung): trägt die Farbe selbst als Emoji, nur Größe passend
    zur Kopfzeile. Eigener Randabstand, damit es neben Titel und Pfad Luft behält. */
-.warnung{font-size:19px;line-height:1;margin:0 4px}
+.warnung{font-size:19px;line-height:1;margin:0 4px;display:inline-flex;align-items:center;gap:6px}
+/* Warnzahl neben dem Dreieck (E75): dieselbe Optik wie die Skill-Zahl rechts im selben Kopf, damit
+   zwei Zahlen in einer Zeile nicht nach zwei Bauteilen aussehen. Das Dreieck davor trennt sie. */
+.warnzahl{font-family:var(--mono);font-size:16px;color:var(--emaille-zahl)}
 /* Pfeil-Indikator des Akkordeons: zeigt zu, dreht sich beim Aufklappen. */
 .akkordeonpfeil{flex:none;width:15px;height:15px;stroke:var(--emaille-hell);fill:none;stroke-width:1.8;transition:transform .14s ease}
 .zielkopf[aria-expanded="true"] .akkordeonpfeil{transform:rotate(180deg)}
@@ -336,9 +378,8 @@ a{color:var(--signal-tief)}
 .ziel.verzeichnis .zielkoerper > .kartenchips + *{border-top:0;margin-top:0;padding-top:0}
 .kartenchips .hsymbol{margin-right:6px}
 /* Zielordner des gewählten Harness, wie ihn vorher der Abschnittskopf trug (25cddf6): rechts in der
-   Chip-Leiste, daneben die Inaktiv-Marke. */
+   Chip-Leiste. */
 .kartenchips .kartenordner{margin-left:auto;align-self:center;color:var(--tinte-weich);word-break:break-all}
-.kartenchips .ruhend{align-self:center}
 
 .hsymbol{flex:none;width:17px;height:17px;margin-right:8px;vertical-align:-.19em}
 /* Das Hermes-Zeichen ist ein Bitmap-Favicon mit weißem Grund: leicht gerundet wie eine Tab-Kachel. */
@@ -533,6 +574,9 @@ dialog::backdrop{background:rgba(9,45,37,.62)}
    entfallen ersatzlos, das Icon trägt jetzt die Unterscheidung. */
 .quellenliste{list-style:none;margin:0;padding:0;display:flex;flex-direction:column;gap:15px}
 .quellenliste li{display:grid;grid-template-columns:20px minmax(0,1fr) auto;gap:3px 10px;align-items:center}
+/* Der Leertext ist keine Quellenzeile (E75): ohne diese Ausnahme fiele er als einziges Grid-Kind in
+   die 20px-Icon-Spalte und bräche Wort für Wort um. Erbt sonst die Optik der übrigen Leerhinweise. */
+.quellenliste li.leerhinweis{display:block}
 .quellenliste .repo{grid-column:1;grid-row:1}
 /* Umbenennen und Entfernen sitzen zusammen in Spalte 3, sonst lägen sie als eigene Grid-Kinder
    beide in derselben Zelle übereinander. Spalte und Zeile stehen ausdrücklich da, damit sie nicht
@@ -555,12 +599,16 @@ dialog::backdrop{background:rgba(9,45,37,.62)}
 
 /* Harness-Schalter im Einstellungen-Dialog (entwurf/gui.html). */
 .harnessliste{list-style:none;margin:0;padding:0;display:flex;flex-direction:column;gap:9px}
-.harnessschalter{
-  display:grid;grid-template-columns:auto minmax(0,1fr);gap:14px;align-items:start;cursor:pointer;
+/* Die Box ist das Listenelement, nicht das Label: so liegen die Homedir-Zeilen (E78) mit in der
+   Box, ohne dass ein Klick auf ihre Knöpfe den Schalter umlegt. */
+.harnessliste > li{
   background:var(--blech);border:1px solid var(--strich-ui);border-radius:3px;padding:12px 15px;
   transition:border-color .12s ease;
 }
-.harnessschalter:hover{border-color:var(--tinte-weich)}
+.harnessliste > li:hover{border-color:var(--tinte-weich)}
+.harnessschalter{
+  display:grid;grid-template-columns:auto minmax(0,1fr);gap:14px;align-items:start;cursor:pointer;
+}
 .harnessschalter input{
   appearance:none;-webkit-appearance:none;
   margin:3px 0 0;flex:none;width:38px;height:22px;
@@ -576,12 +624,17 @@ dialog::backdrop{background:rgba(9,45,37,.62)}
 .harnessschalter b{display:flex;align-items:center;font-family:var(--mono);font-weight:500;font-size:16px;color:var(--tinte);line-height:1.35;word-break:break-word}
 .harnessschalter small{display:block;font-size:16px;color:var(--tinte-weich);line-height:1.4}
 
-/* Ziel eines abgeschalteten Harness: still, kein Alarm, nur ein Vermerk. */
-.ruhend{
-  font-family:var(--schrift);font-weight:700;font-size:15px;letter-spacing:.1em;text-transform:uppercase;
-  background:var(--platte);color:var(--tinte);border-radius:2px;padding:2px 9px;border:1px solid var(--strich-ui);
-}
-/* Der Weg zurück für Konfiguration, die keinen aktiven Harness mehr hat. */
+/* Homedirs unter dem Schalter (E78), in derselben Box: je Zeile Art, Pfad und die Knöpfe dazu.
+   Eingerückt auf die Textspalte des Schalters (Schalterbreite plus Spaltenabstand). */
+.heime{display:flex;flex-direction:column;gap:6px;margin:8px 0 0 52px}
+.heime:empty{display:none}
+.heimzeile{display:flex;flex-wrap:wrap;align-items:center;gap:6px 10px}
+.heimart{flex:none;font-size:15px;color:var(--tinte-weich)}
+.heimpfad{flex:1 1 200px;min-width:0;font-family:var(--mono);font-size:15px;color:var(--tinte);overflow-wrap:anywhere}
+.heimknoepfe{flex:none;display:flex;flex-wrap:wrap;gap:6px}
+.heime > .knopf{align-self:flex-start}
+
+/* Hinweiskasten in ruhiger Messing-Optik, heute nur noch in der MCP-Ansicht (E61). */
 .ruhezeile{
   display:flex;flex-wrap:wrap;gap:10px 14px;align-items:center;
   margin-bottom:14px;padding:11px 14px;

package/dist/kern/anwendungsfaelle.js

@@ -1,8 +1,8 @@
 // Anwendungsfälle. Pfade werden hier nur als Zeichenketten normalisiert, gelesen wird über die Ports.
 import path from 'node:path';
-import { AbhaengigkeitFehlt, BundleMehrdeutig, BundleMitgliederFehlen, BundleNamenskonflikte, BundleNichtInstalliert, BundleUnbekannt, EinschraenkungOhneZeiger, FremderEintragUnbekannt, HarnessNichtVorhanden, HarnessTypUnbekannt, KeinPassenderRef, McpEbeneNichtUnterstuetzt, McpFaehigkeitFehlt, McpUebernahmeNichtMoeglich, McpUnbekannt, OrtNichtUnterstuetzt, PluginMehrdeutig, PluginUnbekannt, QuelleAufraeumenLokaleAenderungen, QuelleNameBelegt, QuelleUnbekannt, SkillMehrdeutig, SkillOrdnerBereitsVerwaltet, SkillOrdnerFaehigkeitFehlt, SkillOrdnerNichtVerwaltet, SkillUnbekannt, ZeigerMehrdeutig, ZeigerSchreibenGesperrt, bundleSchluessel, marketplaceUrl, pluginSchluessel, pluginSchluesselZerlegen, quelleAlsText, quelleMitNamen, quelleName, quelleNameAbleiten, quelleNameFrei, quelleSchluessel, zielSchluessel, } from "./modell.js";
+import { AbhaengigkeitFehlt, BundleMehrdeutig, BundleMitgliederFehlen, BundleNamenskonflikte, BundleNichtInstalliert, BundleUnbekannt, EinschraenkungOhneZeiger, FremderEintragUnbekannt, HarnessInaktiv, HarnessNichtVorhanden, HarnessTypUnbekannt, HeimAdresseUngueltig, HeimBereitsVorhanden, HeimFaehigkeitFehlt, HeimNurUnterWindows, HeimUnbekannt, KeinPassenderRef, McpEbeneNichtUnterstuetzt, McpFaehigkeitFehlt, McpUebernahmeNichtMoeglich, McpUnbekannt, OrtNichtUnterstuetzt, PluginMehrdeutig, PluginUnbekannt, QuelleAufraeumenLokaleAenderungen, QuelleNameBelegt, QuelleUnbekannt, SkillMehrdeutig, SkillOrdnerBereitsVerwaltet, SkillOrdnerFaehigkeitFehlt, SkillOrdnerNichtVerwaltet, SkillUnbekannt, ZeigerMehrdeutig, ZeigerSchreibenGesperrt, bundleSchluessel, heimAdresseAlsText, heimAdresseZerlegen, marketplaceUrl, pluginSchluessel, pluginSchluesselZerlegen, quelleAlsText, quelleMitNamen, quelleName, quelleNameAbleiten, quelleNameFrei, quelleSchluessel, zielSchluessel, } from "./modell.js";
 import { passenderRef } from "./version.js";
-import { kannIstRegistriert, kannMcp, kannPlugins, kannProfile, kannSkillOrdner, kannZurueckbauen, } from "../ports/harness.js";
+import { kannIstRegistriert, kannMcp, kannPlugins, kannProfile, kannSkillOrdner, kannZurueckbauen, kannZusaetzlicheHeime, } from "../ports/harness.js";
 /**
  * Frage vor dem Löschen, eine für alle Kandidaten (E28). Der Kern formuliert sie fertig, der
  * Adapter stellt sie: Anzahl und Pfade, damit der Nutzer sieht, worüber er entscheidet.
@@ -83,6 +83,19 @@ export class Anwendungsfaelle {
             throw new HarnessNichtVorhanden(name);
         return h;
     }
+    /**
+     * Wächter vor jedem neu angelegten Link (E76): in ein Ziel eines deaktivierten Harness legt hmgr
+     * keinen. Seit E74 zeigt keine Ansicht solche Ziele, der Link wäre unsichtbarer Zustand. Sitzt in
+     * `linkLegen` und `bundleInstallieren`, also vor jeder Wirkung und für CLI wie GUI gleich.
+     * Bewusst nicht in `linkAnlegen`: über den laufen auch Abgleich und Aktualisierung, und die
+     * pflegen bestehende Links weiter, statt neue anzulegen.
+     */
+    async harnessAktivGeprueft(name) {
+        const harness = await this.harnessGeprueft(name);
+        if (!(await this.aktiveHarnesses()).includes(name))
+            throw new HarnessInaktiv(name);
+        return harness;
+    }
     /** Harnesses, die auf dem Rechner liegen. Alle anderen überspringt hmgr. */
     async vorhandeneHarnesses() {
         const ergebnis = [];
@@ -103,6 +116,130 @@ export class Anwendungsfaelle {
     harnessTypen() {
         return this.p.harnesses.map((h) => h.name);
     }
+    /**
+     * Die Home-Ziele eines Harness (E78, F88): das primäre und jedes zusätzliche Homedir, jedes als
+     * eigenständiges Ziel. Eine Stelle für alle Aufzählungen — Status, Säubern, GUI —, damit ein
+     * zusätzliches Homedir nirgends versehentlich fehlt. Ein `wsl:`-Heim im Zustand einer anderen
+     * Plattform lässt der Port weg (Entscheidung 7), hier kommt es dann gar nicht erst an.
+     */
+    homeZiele(harness) {
+        if (!harness.orte().includes('home'))
+            return [];
+        const ziele = [{ harness: harness.name, ort: { art: 'home' } }];
+        if (kannZusaetzlicheHeime(harness))
+            for (const heim of this.p.heime.zusaetzliche(harness.name))
+                ziele.push({ harness: harness.name, ort: { art: 'home', heim: heim.adresse } });
+        return ziele;
+    }
+    /**
+     * Die Homedirs aller Harness-Typen, für `hmgr harness home` und die GUI (E78). Unabhängig davon,
+     * ob der Harness aktiv oder installiert ist: die Einstellung gehört dem Nutzer, nicht dem Ist-Zustand.
+     */
+    async harnessHeime() {
+        const zustand = await this.p.zustand.lesen();
+        return this.p.harnesses.map((harness) => {
+            const eintrag = zustand.harnessHeime.find((h) => h.harness === harness.name);
+            const primaer = {
+                pfad: this.p.heime.primaer(harness.name),
+                eingestellt: eintrag?.pfad !== undefined && eintrag.pfad.length > 0,
+            };
+            const zusaetzliche = this.p.heime
+                .zusaetzliche(harness.name)
+                .map((h) => ({ adresse: h.adresse, pfad: h.pfad, eingestellt: true }));
+            return {
+                harness: harness.name,
+                heime: [primaer, ...zusaetzliche],
+                kannZusaetzliche: kannZusaetzlicheHeime(harness),
+            };
+        });
+    }
+    /** Der Eintrag dieses Harness im Zustand, notfalls neu angelegt (E78). */
+    static heimEintrag(zustand, harness) {
+        let eintrag = zustand.harnessHeime.find((h) => h.harness === harness);
+        if (eintrag === undefined) {
+            eintrag = { harness, zusaetzliche: [] };
+            zustand.harnessHeime.push(eintrag);
+        }
+        return eintrag;
+    }
+    /** Einträge ohne Inhalt fallen weg, damit die state.json nicht mit leeren Hüllen zuwächst. */
+    static heimeAufraeumen(zustand) {
+        zustand.harnessHeime = zustand.harnessHeime.filter((h) => (h.pfad !== undefined && h.pfad.length > 0) || h.zusaetzliche.length > 0);
+    }
+    /**
+     * Primäres Homedir umstellen (E78, F89): hmgr merkt sich den neuen Pfad und zeigt ab dann ihn.
+     * Was am alten Ort liegt, bleibt unberührt liegen — dasselbe Verhalten wie beim Deaktivieren
+     * (E74). Wer umziehen will, verlinkt am neuen Ort neu; einen Umzugsassistenten gibt es bewusst
+     * nicht. Der Pfad wird nicht geprüft: ein Homedir, das erst noch entsteht, ist ein gültiger Wunsch.
+     */
+    async harnessHeimSetzen(harnessName, pfad) {
+        this.harness(harnessName); // wirft HarnessTypUnbekannt bei unbekanntem Namen
+        const aufgeloest = path.resolve(pfad);
+        const zustand = await this.p.zustand.lesen();
+        Anwendungsfaelle.heimEintrag(zustand, harnessName).pfad = aufgeloest;
+        await this.p.zustand.schreiben(zustand);
+        return aufgeloest;
+    }
+    /** Gegenstück zu `harnessHeimSetzen` (E78, F89): wieder das Home des Nutzers, nichts wird verschoben. */
+    async harnessHeimZuruecksetzen(harnessName) {
+        this.harness(harnessName);
+        const zustand = await this.p.zustand.lesen();
+        const eintrag = zustand.harnessHeime.find((h) => h.harness === harnessName);
+        if (eintrag === undefined || eintrag.pfad === undefined)
+            return;
+        delete eintrag.pfad;
+        Anwendungsfaelle.heimeAufraeumen(zustand);
+        await this.p.zustand.schreiben(zustand);
+    }
+    /**
+     * Zusätzliches Homedir hinzufügen (E78, F87): Adresse `wsl:<distro>`, ohne Benutzer-Option —
+     * wsl.exe startet als Standardbenutzer der Distro, derselbe, der Claude Code dort nutzt. Das Home
+     * wird einmal ermittelt und gespeichert, nicht bei jedem Lauf neu erfragt: sonst hinge jede
+     * Ansicht an einem startenden WSL. Der Aufrufer zeigt den ermittelten Pfad an.
+     */
+    async harnessHeimHinzufuegen(harnessName, adresse) {
+        const harness = this.harness(harnessName);
+        if (!kannZusaetzlicheHeime(harness))
+            throw new HeimFaehigkeitFehlt(harnessName);
+        const zerlegt = heimAdresseZerlegen(adresse);
+        if (zerlegt === undefined)
+            throw new HeimAdresseUngueltig(adresse);
+        const normalisiert = heimAdresseAlsText(zerlegt);
+        // Plattformgrenze (Entscheidung 7): ein WSL-Heim lässt sich nur unter Windows anlegen und
+        // bedienen. Ohne die Prüfung stünde hier ein Eintrag, den derselbe Rechner nie wieder sieht.
+        if (this.p.umgebung.plattform() !== 'win32')
+            throw new HeimNurUnterWindows(normalisiert, this.p.umgebung.plattform());
+        const zustand = await this.p.zustand.lesen();
+        const eintrag = Anwendungsfaelle.heimEintrag(zustand, harnessName);
+        if (eintrag.zusaetzliche.some((h) => h.adresse === normalisiert))
+            throw new HeimBereitsVorhanden(harnessName, normalisiert);
+        const pfad = await this.p.wsl.home(zerlegt.distro);
+        eintrag.zusaetzliche.push({ adresse: normalisiert, pfad });
+        await this.p.zustand.schreiben(zustand);
+        return { adresse: normalisiert, pfad };
+    }
+    /**
+     * Zusätzliches Homedir entfernen (E78): hmgr vergisst es, die Links dort bleiben liegen — wie bei
+     * jedem anderen „nicht mehr gemanagt" (E74, F89). Wer sie los werden will, entfernt sie vorher.
+     */
+    async harnessHeimEntfernen(harnessName, adresse) {
+        this.harness(harnessName);
+        const zerlegt = heimAdresseZerlegen(adresse);
+        const normalisiert = zerlegt === undefined ? adresse : heimAdresseAlsText(zerlegt);
+        const zustand = await this.p.zustand.lesen();
+        const eintrag = zustand.harnessHeime.find((h) => h.harness === harnessName);
+        if (eintrag === undefined || !eintrag.zusaetzliche.some((h) => h.adresse === normalisiert))
+            throw new HeimUnbekannt(harnessName, normalisiert);
+        eintrag.zusaetzliche = eintrag.zusaetzliche.filter((h) => h.adresse !== normalisiert);
+        Anwendungsfaelle.heimeAufraeumen(zustand);
+        await this.p.zustand.schreiben(zustand);
+    }
+    /** Die installierten WSL-Distros, für die Auswahl beim Hinzufügen (E78, F87). */
+    async wslDistros() {
+        if (this.p.umgebung.plattform() !== 'win32')
+            return [];
+        return await this.p.wsl.distros().catch(() => []);
+    }
     /**
      * Harness-Typen, die hmgr verwaltet (E38, GRILL.md Runde 2). Nur für sie richtet hmgr beim
      * Arbeitsverzeichnis-Hinzufügen und beim Abgleich etwas ein. Standard: nur claude-code.
@@ -291,6 +428,8 @@ export class Anwendungsfaelle {
             if (!kannMcp(harness))
                 continue;
             const ebenen = harness.mcp.ebenen();
+            // Nur das primäre Homedir (E78): die claude-CLI dieses Rechners bedient die Konfiguration
+            // einer WSL-Distro nicht, dort gibt es keine MCP-Server zu verwalten.
             if (ebenen.includes('home'))
                 ziele.push({ harness: harness.name, ort: { art: 'home' } });
             if (ebenen.includes('profil') && kannProfile(harness))
@@ -354,9 +493,7 @@ export class Anwendungsfaelle {
     async saeubern(harnessName) {
         const harness = this.harness(harnessName); // wirft HarnessTypUnbekannt bei unbekanntem Namen
         const zustand = await this.p.zustand.lesen();
-        const ziele = [];
-        if (harness.orte().includes('home'))
-            ziele.push({ harness: harness.name, ort: { art: 'home' } });
+        const ziele = [...this.homeZiele(harness)];
         if (harness.orte().includes('profil') && kannProfile(harness))
             for (const name of await harness.profile())
                 ziele.push({ harness: harness.name, ort: { art: 'profil', name } });
@@ -887,7 +1024,7 @@ export class Anwendungsfaelle {
      * legt der Aufruf seine Links wie mit `--local` und trifft die Sperre aus E57 nie.
      */
     async bundleInstallieren(args) {
-        const harness = await this.harnessGeprueft(args.ziel.harness);
+        const harness = await this.harnessAktivGeprueft(args.ziel.harness);
         if (!harness.orte().includes(args.ziel.ort.art))
             throw new OrtNichtUnterstuetzt(harness.name, args.ziel.ort.art);
         const bundle = await this.bundleFinden(args.bundle, args.quelle);
@@ -1160,7 +1297,7 @@ export class Anwendungsfaelle {
      * hätte sie keinen Platz und der Aufruf schlägt fehl.
      */
     async linkLegen(args) {
-        const harness = await this.harnessGeprueft(args.ziel.harness);
+        const harness = await this.harnessAktivGeprueft(args.ziel.harness);
         if (!harness.orte().includes(args.ziel.ort.art))
             throw new OrtNichtUnterstuetzt(harness.name, args.ziel.ort.art);
         const version = args.version;
@@ -1586,9 +1723,15 @@ export class Anwendungsfaelle {
      * Checkouts, deren Quelle der Zustand nicht führt, bleiben ganz außen vor (E54): sie werden weder
      * geholt noch als verwaist zum Löschen angeboten. Eine vergessene Quelle ist vergessen, ihre
      * Checkouts und Links liegen unangetastet, bis die Quelle wieder hinzukommt.
+     *
+     * Schreibt am Ende einen Verlaufseintrag (E80), aber nur, wenn der Lauf mindestens ein Ereignis
+     * ergeben hat: unveränderte oder übersprungene Checkouts und Bundles ohne Änderung erzeugen
+     * nichts, ein leerer Lauf bleibt ganz aus dem Changelog. `ausloeser` steht mit im Eintrag, damit
+     * der Verlauf zeigt, ob ein Fund vom automatischen Lauf, einem Klick oder der CLI kam.
      */
     async aktualisieren(args) {
         const rueckfragen = args?.rueckfragen ?? true;
+        const ausloeser = args?.ausloeser ?? 'cli';
         const bekannt = new Map((await this.p.zustand.lesen()).quellen.map((q) => [quelleSchluessel(q), q]));
         const checkouts = [];
         for (const checkout of await this.p.quellen.checkouts()) {
@@ -1623,12 +1766,97 @@ export class Anwendungsfaelle {
         // danach steht fest, in welchen Checkout noch ein Link zeigt. Ein Fehlschlag je Bundle steckt
         // in seinem Eintrag, er bricht den Lauf nicht ab — wie eine unerreichbare Quelle (E51).
         const bundles = await this.bundleAbgleich();
-        return {
-            checkouts,
-            pluginHarnesses,
-            bundles,
-            aufraeumen: await this.verwaisteAufraeumen(checkouts, rueckfragen),
+        const aufraeumen = await this.verwaisteAufraeumen(checkouts, rueckfragen);
+        await this.verlaufVermerken(ausloeser, this.aktualisierungsEreignisse(checkouts, bundles, aufraeumen));
+        return { checkouts, pluginHarnesses, bundles, aufraeumen };
+    }
+    /**
+     * Ereignisse eines Aktualisieren-Laufs für den Verlauf (E80): Plugins bleiben draußen, weil sich
+     * eine Änderung dort nicht messen lässt (`claude plugin marketplace update` liefert keine
+     * Auskunft) — die bisherige Zeile „Plugins aktualisiert" war deshalb geschönt.
+     */
+    aktualisierungsEreignisse(checkouts, bundles, aufraeumen) {
+        const ereignisse = [];
+        for (const { checkout, aktualisierung, geaenderteSkills } of checkouts) {
+            if (aktualisierung.ergebnis === 'aktualisiert')
+                ereignisse.push({
+                    art: 'checkout',
+                    quelle: quelleAlsText(checkout.quelle),
+                    ref: checkout.ref,
+                    von: aktualisierung.von,
+                    nach: aktualisierung.nach,
+                    skills: geaenderteSkills,
+                });
+            else if (aktualisierung.ergebnis === 'fehlgeschlagen')
+                ereignisse.push({
+                    art: 'fehler',
+                    betrifft: `${quelleAlsText(checkout.quelle)} @ ${checkout.ref}`,
+                    fehler: aktualisierung.fehler,
+                });
+        }
+        for (const eintrag of bundles) {
+            if (eintrag.ergebnis === 'fehlgeschlagen')
+                ereignisse.push({ art: 'fehler', betrifft: eintrag.bundle, fehler: eintrag.fehler ?? '' });
+            else if (eintrag.gelegt.length > 0 || eintrag.entfernt.length > 0)
+                ereignisse.push({
+                    art: 'bundle',
+                    bundle: eintrag.bundle,
+                    ziel: eintrag.ziel,
+                    gelegt: eintrag.gelegt,
+                    entfernt: eintrag.entfernt,
+                });
+        }
+        for (const verwaist of aufraeumen.verwaiste)
+            if (verwaist.geloescht)
+                ereignisse.push({ art: 'aufgeraeumt', checkout: `${quelleAlsText(verwaist.checkout.quelle)} @ ${verwaist.checkout.ref}` });
+        return ereignisse;
+    }
+    /** Neuen Eintrag vorn anfügen, nur wenn Ereignisse da sind (E80). Kappen übernimmt der Adapter. */
+    async verlaufVermerken(ausloeser, ereignisse) {
+        if (ereignisse.length === 0)
+            return;
+        const daten = await this.p.verlauf.lesen();
+        const eintrag = { zeit: new Date().toISOString(), ausloeser, ereignisse };
+        await this.p.verlauf.schreiben({ gemerkt: daten.gemerkt, eintraege: [eintrag, ...daten.eintraege] });
+    }
+    /** Der Verlauf, neueste zuerst (E80). */
+    async verlauf() {
+        return (await this.p.verlauf.lesen()).eintraege;
+    }
+    /**
+     * Merkt die installierte Version eines hmgr-Pakets (GUI oder CLI) und schreibt bei einem
+     * Versionssprung einen Verlaufseintrag (E80). Der erste Aufruf ohne gemerkte Version merkt nur,
+     * ohne Ereignis — sonst bekäme jede Erstinstallation ein irreführendes „installiert".
+     */
+    async versionsSprungVermerken(paket, version, ausloeser) {
+        const daten = await this.p.verlauf.lesen();
+        const bisher = paket === 'gui' ? daten.gemerkt.gui : daten.gemerkt.cli;
+        if (bisher === version)
+            return;
+        const gemerkt = { ...daten.gemerkt, [paket]: version };
+        if (bisher === undefined) {
+            await this.p.verlauf.schreiben({ gemerkt, eintraege: daten.eintraege });
+            return;
+        }
+        const eintrag = {
+            zeit: new Date().toISOString(),
+            ausloeser,
+            ereignisse: [{ art: 'hmgr-installiert', paket, version }],
         };
+        await this.p.verlauf.schreiben({ gemerkt, eintraege: [eintrag, ...daten.eintraege] });
+    }
+    /**
+     * Merkt ein hmgr-eigenes Ereignis (GUI-Update geladen oder CLI-Update auf npm verfügbar) einmal
+     * je neuer Version (E80): dieselbe Version taucht nicht in jedem Lauf erneut im Changelog auf.
+     */
+    async hmgrEreignisVermerken(ereignis, ausloeser) {
+        const daten = await this.p.verlauf.lesen();
+        const feld = ereignis.art === 'gui-update-geladen' ? 'guiGeladen' : 'cliVerfuegbar';
+        if (daten.gemerkt[feld] === ereignis.version)
+            return;
+        const gemerkt = { ...daten.gemerkt, [feld]: ereignis.version };
+        const eintrag = { zeit: new Date().toISOString(), ausloeser, ereignisse: [ereignis] };
+        await this.p.verlauf.schreiben({ gemerkt, eintraege: [eintrag, ...daten.eintraege] });
     }
     /**
      * Welche Skills ein aktualisierter Checkout mitgebracht hat (E70). Die geänderten Pfade kommen
@@ -2005,9 +2233,7 @@ export class Anwendungsfaelle {
         };
         const ergebnis = [];
         for (const harness of await this.vorhandeneHarnesses()) {
-            const ziele = [];
-            if (harness.orte().includes('home'))
-                ziele.push({ harness: harness.name, ort: { art: 'home' } });
+            const ziele = [...this.homeZiele(harness)];
             if (harness.orte().includes('profil') && kannProfile(harness))
                 for (const name of await harness.profile())
                     ziele.push({ harness: harness.name, ort: { art: 'profil', name } });
@@ -2017,7 +2243,9 @@ export class Anwendungsfaelle {
             for (const ziel of ziele) {
                 const verzeichnis = harness.zielVerzeichnis(ziel.ort);
                 const eintraege = await this.p.ziele.eintraege(ziel, verzeichnis).catch(() => []);
-                const plugins = kannPlugins(harness)
+                // Plugins nur am primären Homedir (E78): die claude-CLI dieses Rechners kennt die
+                // Plugin-Konfiguration einer WSL-Distro nicht, ihre user-Liste gehörte zum Windows-Home.
+                const plugins = kannPlugins(harness) && !(ziel.ort.art === 'home' && ziel.ort.heim !== undefined)
                     ? await harness.plugins.installierte(ziel).catch(() => [])
                     : undefined;
                 const zeiger = await this.zeigerFuerZiel(ziel);

package/dist/kern/modell.js

@@ -50,9 +50,108 @@ export function marketplaceUrl(quelle) {
 }
 export function zielSchluessel(ziel) {
     const o = ziel.ort;
-    const ort = o.art === 'home' ? 'home' : o.art === 'profil' ? `profil:${o.name}` : `dir:${o.pfad}`;
+    const ort = o.art === 'home'
+        ? o.heim === undefined
+            ? 'home'
+            : `home:${o.heim}`
+        : o.art === 'profil'
+            ? `profil:${o.name}`
+            : `dir:${o.pfad}`;
     return `${ziel.harness}/${ort}`;
 }
+export function heimAdresseZerlegen(text) {
+    const roh = text.trim();
+    if (!roh.toLowerCase().startsWith('wsl:'))
+        return undefined;
+    const distro = roh.slice('wsl:'.length).trim();
+    if (distro.length === 0)
+        return undefined;
+    return { art: 'wsl', distro };
+}
+/** Die Adresse eines zusätzlichen Heims in der Schreibweise, die hmgr speichert und anzeigt. */
+export function heimAdresseAlsText(adresse) {
+    return `wsl:${adresse.distro}`;
+}
+/** Ein Text, der keine Heim-Adresse ist (E78). */
+export class HeimAdresseUngueltig extends Error {
+    adresse;
+    constructor(adresse) {
+        super(`„${adresse}" ist keine Adresse für ein zusätzliches Homedir. Erwartet wird wsl:<distro>, etwa wsl:Ubuntu.`);
+        this.adresse = adresse;
+    }
+}
+/**
+ * Ein `wsl:`-Heim auf einer Plattform ohne WSL (E78, Entscheidung 7). Steht so eines im Zustand,
+ * weil er von einem Windows-Rechner stammt, wird sein Ziel hier nicht angezeigt und nicht bedient;
+ * Hinzufügen bricht mit dieser Meldung ab.
+ */
+export class HeimNurUnterWindows extends Error {
+    adresse;
+    plattform;
+    constructor(adresse, plattform) {
+        super(`Ein Homedir in WSL („${adresse}") gibt es nur unter Windows, nicht unter ${plattform}.`);
+        this.adresse = adresse;
+        this.plattform = plattform;
+    }
+}
+/** Ein Harness-Typ ohne die Fähigkeit „zusätzliche Homedirs" (E78): heute nur claude-code hat sie. */
+export class HeimFaehigkeitFehlt extends Error {
+    harness;
+    constructor(harness) {
+        super(`Harness ${harness} kennt keine zusätzlichen Homedirs`);
+        this.harness = harness;
+    }
+}
+/** Dieselbe Adresse ist für diesen Harness schon eingetragen (E78). */
+export class HeimBereitsVorhanden extends Error {
+    harness;
+    adresse;
+    constructor(harness, adresse) {
+        super(`${harness} hat schon ein Homedir „${adresse}"`);
+        this.harness = harness;
+        this.adresse = adresse;
+    }
+}
+/** Eine Adresse, die für diesen Harness nicht eingetragen ist (E78): Entfernen kennt nur eingetragene. */
+export class HeimUnbekannt extends Error {
+    harness;
+    adresse;
+    constructor(harness, adresse) {
+        super(`${harness} hat kein Homedir „${adresse}"`);
+        this.harness = harness;
+        this.adresse = adresse;
+    }
+}
+/**
+ * Etwas, das nur am primären Homedir geht, wurde für ein zusätzliches verlangt (E78): die
+ * claude-CLI dieses Rechners bedient das Windows-Home, nicht das einer WSL-Distro — MCP-Server und
+ * Plugins lassen sich dort deshalb nicht verwalten. Skill-Links legt hmgr dort selbst, ohne CLI.
+ */
+export class HeimOhneCliZugriff extends Error {
+    harness;
+    adresse;
+    constructor(harness, adresse, was) {
+        super(`${harness} kann ${was} im Homedir „${adresse}" nicht verwalten: die claude-CLI dieses Rechners bedient nur ` +
+            'das primäre Homedir. Skill-Links legt hmgr dort selbst.');
+        this.harness = harness;
+        this.adresse = adresse;
+    }
+}
+/**
+ * Die Bridge in eine WSL-Distro hat nicht geantwortet (E78): die Distro gibt es nicht, sie startet
+ * nicht, oder wsl.exe fehlt. Die Ausgabe von wsl.exe steht mit in der Meldung — sie nennt den Grund
+ * genauer, als hmgr ihn raten könnte.
+ */
+export class WslBrueckeFehlgeschlagen extends Error {
+    distro;
+    ausgabe;
+    constructor(distro, ausgabe) {
+        const zusatz = ausgabe.trim().length === 0 ? '' : `: ${ausgabe.trim()}`;
+        super(`wsl.exe -d ${distro} ließ sich nicht ausführen${zusatz}`);
+        this.distro = distro;
+        this.ausgabe = ausgabe;
+    }
+}
 /** Wie eine Quelle geschrieben steht: ihre URL oder ihr Pfad. Für Ausgaben, nicht für Vergleiche. */
 export function quelleAlsText(quelle) {
     return quelle.art === 'git' ? quelle.url : quelle.pfad;
@@ -286,6 +385,18 @@ export class HarnessNichtVorhanden extends Error {
         this.harness = harness;
     }
 }
+/**
+ * Ziel eines deaktivierten Harness beim Anlegen eines Links (E76). Seit E74 zeigt keine Ansicht
+ * solche Ziele, ein dort neu gelegter Link wäre unsichtbarer Zustand. Bestehende Links bleiben
+ * unberührt, nur das Neuanlegen ist gesperrt.
+ */
+export class HarnessInaktiv extends Error {
+    harness;
+    constructor(harness) {
+        super(`Harness ${harness} ist deaktiviert, hmgr legt dort keine Links an`);
+        this.harness = harness;
+    }
+}
 /** Ein Name, den kein Harness-Typ trägt: Aktivieren, Deaktivieren und Säubern kennen nur bekannte Typen (E38). */
 export class HarnessTypUnbekannt extends Error {
     harness;

package/dist/kern/version.js

@@ -78,6 +78,19 @@ export function vergleichen(a, b) {
     }
     return 0;
 }
+/**
+ * Ist `neu` eine höhere Version als `alt`? Für den Update-Hinweis (E77): die von npm gemeldete
+ * Version gegen die installierte. Verglichen wird numerisch je Stelle, nie als Text — sonst stünde
+ * „0.0.10" unter „0.0.9". Was sich nicht als Version lesen lässt, gilt als nicht neuer: ein
+ * unverständlicher Text darf nie zu einer Meldung führen, die zum Update auffordert.
+ */
+export function versionIstNeuer(neu, alt) {
+    const a = versionLesen(neu.trim());
+    const b = versionLesen(alt.trim());
+    if (a === null || b === null)
+        return false;
+    return vergleichen(a, b) > 0;
+}
 /**
  * Tilde: „`~1.2` ist gleichbedeutend mit `>=1.2 <2.0.0`, `~1.2.3` mit `>=1.2.3 <1.3.0`", die
  * am weitesten rechts genannte Stelle darf wachsen (getcomposer.org, Writing Version Constraints).

package/dist/ports/dateizugriff.js

@@ -0,0 +1 @@
+export {};

package/dist/ports/harness.js

@@ -1,3 +1,7 @@
+/** Ob dieser Harness-Typ zusätzliche Homedirs bedienen kann (E78). Ohne die Fähigkeit: nein. */
+export function kannZusaetzlicheHeime(h) {
+    return h.zusaetzlicheHeime?.() === true;
+}
 export function kannProfile(h) {
     return typeof h.profile === 'function';
 }

package/dist/ports/heime.js

@@ -0,0 +1 @@
+export {};

package/dist/ports/verlauf.js

@@ -0,0 +1,4 @@
+/** Der leere Verlauf: ohne Datei oder bei kaputtem Inhalt (analog `leererZustand`, zustand.ts). */
+export function leererVerlauf() {
+    return { gemerkt: {}, eintraege: [] };
+}