hmgr 0.0.3 → 0.0.5

package/dist/kern/modell.js

@@ -1,4 +1,5 @@
 // Begriffe aus CONTEXT.md. Nur Werte und Regeln, keine Pfade zu Dateien außerhalb des Modells.
+import { ortSchluessel, urlOrt } from "./quelle-ort.js";
 /** Ansprache eines Plugins im Zeiger und gegenüber der claude-CLI: `<plugin>@<marketplace>`. */
 export function pluginSchluessel(plugin) {
     return `${plugin.name}@${plugin.marketplace}`;
@@ -45,8 +46,80 @@ export function zielSchluessel(ziel) {
     const ort = o.art === 'home' ? 'home' : o.art === 'profil' ? `profil:${o.name}` : `dir:${o.pfad}`;
     return `${ziel.harness}/${ort}`;
 }
+/** 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;
+}
+/**
+ * Identität einer Quelle (E36): bei einer Git-Quelle Host, Besitzer und Repo, nicht die
+ * Schreibweise der URL. SSH- und HTTPS-Form desselben Repos sind dieselbe Quelle, mit und ohne
+ * `.git`-Suffix ebenso, und der Host zählt ohne Rücksicht auf Groß- und Kleinschreibung. Ein Text,
+ * der sich nicht als URL lesen lässt, bleibt sein eigener Schlüssel. Lokale Quellen bleiben ihr
+ * Pfad (B11).
+ */
 export function quelleSchluessel(quelle) {
-    return quelle.art === 'git' ? quelle.url : `lokal:${quelle.pfad}`;
+    if (quelle.art === 'lokal')
+        return `lokal:${quelle.pfad}`;
+    const ort = urlOrt(quelle.url);
+    return ort === undefined ? quelle.url : ortSchluessel(ort);
+}
+/** Letztes nicht leeres Segment eines Pfads oder einer URL, ohne abschließende Schrägstriche. */
+function letztesSegment(text) {
+    const bereinigt = text.replace(/\/+$/, '');
+    const segmente = bereinigt.split('/').filter((s) => s.length > 0);
+    return segmente[segmente.length - 1] ?? bereinigt;
+}
+/**
+ * Abgeleiteter Anzeigename einer Quelle (E59), ohne Rücksicht auf einen gespeicherten Namen: bei
+ * einer Git-Quelle das letzte Pfadsegment der URL ohne `.git`-Suffix (über `urlOrt`, wie E36 den
+ * Repo-Namen schon für die Identität liest), bei einer lokalen Quelle ihr Ordnername.
+ */
+export function quelleNameAbleiten(quelle) {
+    if (quelle.art === 'lokal')
+        return letztesSegment(quelle.pfad);
+    const ort = urlOrt(quelle.url);
+    return ort !== undefined ? ort.repo : letztesSegment(quelle.url);
+}
+/**
+ * Anzeigename einer Quelle (E59): der gespeicherte Name, sonst der abgeleitete. Reine Anzeige,
+ * geht nicht in `quelleSchluessel` ein. CLI und GUI nutzen ausschließlich diesen Helfer.
+ */
+export function quelleName(quelle) {
+    if (quelle.name !== undefined && quelle.name.trim().length > 0)
+        return quelle.name;
+    return quelleNameAbleiten(quelle);
+}
+/**
+ * Ein Anzeigename, den noch keine der genannten Quellen trägt (E59): der Wunschname, sonst mit
+ * angehängter Zahl. Nur für Wege, die eine Quelle nebenbei anlegen (Übernahme, E31): dort gibt es
+ * niemanden, der eine Kollision auflösen könnte, und ein Abbruch ließe die Übernahme ohne Ausweg
+ * scheitern. Wo der Nutzer den Namen selbst nennt, bleibt eine Kollision ein Fehler.
+ */
+export function quelleNameFrei(wunsch, vorhandene) {
+    const belegt = new Set(vorhandene.map(quelleName));
+    if (!belegt.has(wunsch))
+        return wunsch;
+    for (let n = 2;; n += 1) {
+        const kandidat = `${wunsch}-${n}`;
+        if (!belegt.has(kandidat))
+            return kandidat;
+    }
+}
+/** Dieselbe Quelle mit gesetztem Anzeigenamen (E59). `undefined` lässt sie unverändert. */
+export function quelleMitNamen(quelle, name) {
+    if (name === undefined)
+        return quelle;
+    return quelle.art === 'git' ? { art: 'git', url: quelle.url, name } : { art: 'lokal', pfad: quelle.pfad, name };
+}
+/** Ein Anzeigename, den schon eine andere geführte Quelle trägt (E59): Namen sind eindeutig. */
+export class QuelleNameBelegt extends Error {
+    angefragterName;
+    andere;
+    constructor(angefragterName, andere) {
+        super(`Name „${angefragterName}" ist schon vergeben an ${quelleAlsText(andere)}. Einen anderen Namen wählen.`);
+        this.angefragterName = angefragterName;
+        this.andere = andere;
+    }
 }
 export class NameBelegt extends Error {
     ziel;
@@ -73,6 +146,14 @@ export class SkillUnbekannt extends Error {
         this.name = name;
     }
 }
+/** Eine Quelle, die im Zustand nicht geführt wird (E54): Entfernen kennt nur bekannte Quellen. */
+export class QuelleUnbekannt extends Error {
+    quelle;
+    constructor(quelle) {
+        super(`Quelle „${quelleAlsText(quelle)}" ist nicht bekannt`);
+        this.quelle = quelle;
+    }
+}
 export class PluginMehrdeutig extends Error {
     name;
     quellen;
@@ -119,6 +200,36 @@ export class EinschraenkungOhneZeiger extends Error {
         this.einschraenkung = einschraenkung;
     }
 }
+/**
+ * Schreiben in einen composer.json-Zeiger ist gesperrt, bis das Composer-Thema (E41, B13) gesondert
+ * entschieden ist (E57): der Zeiger ist ein geteiltes Team-Artefakt, ein Schreiben ohne Rücksprache
+ * beträfe Kollegen. Lesen bleibt erlaubt, nur link, unlink und plugin add/remove ohne `--local`
+ * treffen diese Sperre.
+ */
+export class ZeigerSchreibenGesperrt extends Error {
+    ziel;
+    constructor(ziel) {
+        super(`Schreiben in den Zeiger von ${zielSchluessel(ziel)} ist gesperrt, bis das Composer-Thema entschieden ist – ` +
+            'der Zeiger ist ein geteiltes Team-Artefakt. Nutze --local.');
+        this.ziel = ziel;
+    }
+}
+/**
+ * `quelleAufraeumen` bricht ab, wenn ein Checkout der Quelle lokale Änderungen hat (E15, F31a):
+ * geprüft VOR der ersten Löschung, nichts wird gelöscht, kein stilles Teil-Überspringen. Der
+ * Aufrufer lässt bei diesem Fehler auch das Vergessen der Quelle unterbleiben, alles bleibt liegen.
+ */
+export class QuelleAufraeumenLokaleAenderungen extends Error {
+    checkouts;
+    constructor(checkouts) {
+        const kopf = checkouts.length === 1
+            ? 'Ein Checkout hat lokale Änderungen, nichts wurde gelöscht:'
+            : `${checkouts.length} Checkouts haben lokale Änderungen, nichts wurde gelöscht:`;
+        const pfade = checkouts.map((c) => `  ${c.pfad}`).join('\n');
+        super(`${kopf}\n${pfade}\nCommitte/pushe die Änderungen oder verwirf sie, danach lässt sich das Entfernen wiederholen.`);
+        this.checkouts = checkouts;
+    }
+}
 export class OrtNichtUnterstuetzt extends Error {
     harness;
     ort;
@@ -144,3 +255,66 @@ export class HarnessNichtVorhanden extends Error {
         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;
+    constructor(harness) {
+        super(`„${harness}" ist kein bekannter Harness-Typ`);
+        this.harness = harness;
+    }
+}
+/**
+ * Ein genannter Name, unter dem am Ziel kein fremder Eintrag liegt (E46): weder Übernehmen mit
+ * Eintrag-Auswahl noch Löschen kennen einen anderen als einen tatsächlich fremden Eintrag. Ein
+ * hmgr-eigener Link zählt hier ebenso wenig wie ein Name, der gar nicht existiert.
+ */
+export class FremderEintragUnbekannt extends Error {
+    ziel;
+    name;
+    constructor(ziel, name) {
+        super(`Im Ziel ${zielSchluessel(ziel)} liegt kein fremder Eintrag „${name}"`);
+        this.ziel = ziel;
+        this.name = name;
+    }
+}
+/** Ein Harness-Typ ohne die Fähigkeit „verwalteter Skill-Ordner" (E56): heute nur hermes. */
+export class SkillOrdnerFaehigkeitFehlt extends Error {
+    harness;
+    constructor(harness) {
+        super(`Harness ${harness} kennt keinen verwalteten Skill-Ordner`);
+        this.harness = harness;
+    }
+}
+/** Für ein Ziel ist schon ein Skill-Ordner verwaltet (E56): Festlegen erlaubt nur genau einen. */
+export class SkillOrdnerBereitsVerwaltet extends Error {
+    ziel;
+    pfad;
+    constructor(ziel, pfad) {
+        super(`Für ${zielSchluessel(ziel)} ist schon ein Skill-Ordner verwaltet: ${pfad}`);
+        this.ziel = ziel;
+        this.pfad = pfad;
+    }
+}
+/** Für ein Ziel ist kein Skill-Ordner verwaltet (E56): Entfernen kennt nur einen vorhandenen Eintrag. */
+export class SkillOrdnerNichtVerwaltet extends Error {
+    ziel;
+    constructor(ziel) {
+        super(`Für ${zielSchluessel(ziel)} ist kein Skill-Ordner verwaltet`);
+        this.ziel = ziel;
+    }
+}
+/**
+ * Ein Pfad, der als verwalteter Skill-Ordner nicht in Frage kommt (E56): außerhalb des
+ * Hermes-Home oder Hermes' eigener Ordner `skills` (oder darunter).
+ */
+export class SkillOrdnerUngueltig extends Error {
+    pfad;
+    grund;
+    constructor(pfad, grund) {
+        super(grund === 'ausserhalb'
+            ? `${pfad} liegt nicht unterhalb des Hermes-Home`
+            : `${pfad} ist Hermes' eigener Skill-Ordner`);
+        this.pfad = pfad;
+        this.grund = grund;
+    }
+}

package/dist/kern/quelle-ort.js

@@ -0,0 +1,42 @@
+// Identität einer Git-Quelle (E36): Host, Besitzer und Repo, nicht die Schreibweise der URL.
+function ohneGitSuffix(name) {
+    return name.endsWith('.git') ? name.slice(0, -4) : name;
+}
+/**
+ * Die letzten beiden nicht leeren Segmente sind Besitzer und Repo. Der Host wird kleingeschrieben,
+ * Hostnamen sind case-insensitiv; der Pfadanteil bleibt, wie er geschrieben steht (E36).
+ */
+export function ortAusSegmenten(host, segmente) {
+    const gefiltert = segmente.filter((s) => s.length > 0);
+    const repo = ohneGitSuffix(gefiltert[gefiltert.length - 1] ?? 'repo');
+    const besitzer = gefiltert[gefiltert.length - 2] ?? '_';
+    return { host: host.toLowerCase(), besitzer, repo };
+}
+/**
+ * Zerlegt eine Git-URL: `git@host:besitzer/repo.git`, `ssh://git@host/besitzer/repo`,
+ * `https://host/besitzer/repo.git`, `file:///pfad`. Ein Text, der keine URL ist, gibt undefined.
+ */
+export function urlOrt(url) {
+    const text = url.trim().replace(/\/+$/, '');
+    if (text.includes('://')) {
+        let zerlegt;
+        try {
+            zerlegt = new URL(text);
+        }
+        catch {
+            return undefined;
+        }
+        const segmente = decodeURIComponent(zerlegt.pathname).split('/');
+        // file: hat keinen Host, alle lokalen Quellen liegen unter „local".
+        if (zerlegt.protocol === 'file:')
+            return ortAusSegmenten('local', segmente);
+        return ortAusSegmenten(zerlegt.hostname, segmente);
+    }
+    const scp = /^(?:[^@/]+@)?([^@/:]+):(.+)$/.exec(text);
+    if (scp)
+        return ortAusSegmenten(scp[1], scp[2].split('/'));
+    return undefined;
+}
+export function ortSchluessel(ort) {
+    return `${ort.host}/${ort.besitzer}/${ort.repo}`;
+}

package/dist/ports/harness.js

@@ -4,3 +4,16 @@ export function kannProfile(h) {
 export function kannPlugins(h) {
     return h.plugins !== undefined;
 }
+export function kannZurueckbauen(h) {
+    return typeof h.zurueckbauen === 'function';
+}
+export function kannIstRegistriert(h) {
+    return typeof h.istRegistriert === 'function';
+}
+export function kannSkillOrdner(h) {
+    return (typeof h.verwalteterSkillOrdner === 'function' &&
+        typeof h.skillOrdnerOrte === 'function' &&
+        typeof h.skillOrdnerFestlegen === 'function' &&
+        typeof h.skillOrdnerEntfernen === 'function' &&
+        typeof h.skillOrdnerLoeschen === 'function');
+}

package/dist/ports/zustand.js

@@ -1,3 +1,3 @@
 export function leererZustand() {
-    return { quellen: [], arbeitsverzeichnisse: [], bindungen: [] };
+    return { quellen: [], arbeitsverzeichnisse: [], bindungen: [], aktiveHarnesses: ['claude-code'], ignorierteEintraege: [] };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hmgr",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "description": "Harness Manager: Skills und Plugins für AI-Harnesses verwalten",
   "license": "MIT",
   "author": "Tim Kaufmann",
@@ -18,7 +18,9 @@
   },
   "scripts": {
     "dev": "node src/cli/main.ts",
-    "build": "tsc -p tsconfig.build.json",
+    "build": "tsc -p tsconfig.build.json && node scripts/copy-gui-assets.mjs",
+    "gui": "npm run build && electron dist/gui/main.js",
+    "gui:smoke": "npm run build && node scripts/gui-smoke-test.ts",
     "test": "vitest run",
     "test:watch": "vitest",
     "type-check": "tsc --noEmit",
@@ -29,6 +31,7 @@
   },
   "devDependencies": {
     "@types/node": "^24.0.0",
+    "electron": "^44.0.0",
     "typescript": "^5.9.0",
     "vitest": "^3.2.0"
   },