hmgr 0.0.51 → 0.0.52

package/dist/adapter/agents.js

@@ -51,6 +51,9 @@ export class Agents {
         if (ort.art === 'arbeitsverzeichnis' && (await istGitRepo(ort.pfad)))
             await gitignoreEintragen(ort.pfad, GITIGNORE_ZEILE);
     }
+    quellOrdner() {
+        return `${AGENTS_VERZEICHNIS}/${SKILLS_ORDNER}`;
+    }
     folgtLinks() {
         return true;
     }

package/dist/adapter/claude-code.js

@@ -681,6 +681,9 @@ export class ClaudeCode {
         if (ort.art === 'arbeitsverzeichnis' && (await istGitRepo(ort.pfad)))
             await gitignoreEintragen(ort.pfad, GITIGNORE_ZEILE);
     }
+    quellOrdner() {
+        return `${CLAUDE_VERZEICHNIS}/${SKILLS_ORDNER}`;
+    }
     folgtLinks() {
         return true;
     }

package/dist/adapter/hermes.js

@@ -289,6 +289,9 @@ export class Hermes {
         await mkdir(hermesHome, { recursive: true });
         await writeFile(pfad, doc.toString());
     }
+    quellOrdner() {
+        return `${HERMES_VERZEICHNIS}/${EIGENER_ORDNER}`;
+    }
     folgtLinks() {
         return true;
     }

package/dist/aenderungen.json

@@ -1,6 +1,9 @@
 {
   "fassung": 1,
   "versionen": {
+    "0.0.52": [
+      "Liegt ein Skill in einem Repo in mehreren Fassungen, je Werkzeug eine (etwa `.claude/skills` und `.hermes/skills`), verlinkt hmgr jetzt für jeden Harness die passende Fassung. Gibt es keine passende, nennt die Meldung die Pfade, und `hmgr link … --pfad` wählt einen aus."
+    ],
     "0.0.51": [
       "Ein gelöschter Projektordner, an dem noch ein Bundle hing, wird beim Aktualisieren nicht mehr neu angelegt. `hmgr doctor` findet solche Ordner jetzt und bietet an, sie samt ihren Bundles zu vergessen."
     ],

package/dist/cli/hilfe.js

@@ -147,6 +147,7 @@ Schalter:
   --ort <ort>         home, wsl:<distro>, dir:<pfad> oder profil:<name>, Standard home. profil
                       kennt nur hermes, wsl:<distro> nur claude-code unter Windows (E78)
   --quelle <teil>     Teilstring der Quelle, wenn der Skill-Name in mehreren Quellen vorkommt
+  --pfad <skill-pfad> Skill-Ordner in der Quelle, wenn der Name dort mehrfach vorkommt (E121)
   --version <spanne>  Versionseinschränkung nach Composer-Regeln (etwa ^1.2) oder ein Tag- oder
                       Branchname. Nur mit Zeiger, also dir:<pfad> ohne --local (E33)
   --composer <pfad>   composer.json des Arbeitsverzeichnisses, wenn mehrere in Frage kommen
@@ -155,11 +156,15 @@ Schalter:
 
 Beispiele:
   hmgr link netzwerk
+  hmgr link impeccable --pfad plugin/skills/impeccable
   hmgr link netzwerk --harness hermes --ort profil:researcher
   hmgr link tq-schema --ort dir:. --version ^2.0
 
 Häufige Fälle:
   „liegt in mehreren Quellen": mit --quelle <teilstring der URL oder des Pfads> entscheiden.
+  „liegt in der Quelle … mehrfach": mit --pfad einen der genannten Pfade wählen. Liegt genau
+  eine Fassung im Skill-Ordner des Harness (claude-code .claude/skills, hermes .hermes/skills,
+  agents .agents/skills), nimmt hmgr sie von selbst und fragt nicht nach.
   „liegt bereits ein fremder Eintrag": --ersetzen setzen oder vorher hmgr adopt <name>.
   „gibt es keinen Zeiger": --version braucht ein Arbeitsverzeichnis mit composer.json und kein
   --local. Ohne Zeiger den Link ohne --version legen.

package/dist/cli/main.js

@@ -121,7 +121,7 @@ const SCHALTER = {
     source: { werte: ['name'], flaggen: [] },
     dir: { werte: ['composer'], flaggen: [] },
     link: {
-        werte: ['harness', 'ort', 'composer', 'quelle', 'version'],
+        werte: ['harness', 'ort', 'composer', 'quelle', 'version', 'pfad'],
         flaggen: ['local', 'lokal', 'ersetzen'],
     },
     unlink: { werte: ['harness', 'ort', 'composer'], flaggen: ['local', 'lokal'] },
@@ -507,10 +507,12 @@ export async function ausfuehren(argv, umgebung, optionen = {}) {
         }
         const quelle = werte.get('quelle');
         const version = werte.get('version');
+        const pfad = werte.get('pfad');
         const link = await anwendungsfaelle.linkLegen({
             skill,
             ziel,
             ...(quelle === undefined ? {} : { quelle }),
+            ...(pfad === undefined ? {} : { pfad }),
             ...(version === undefined ? {} : { version }),
             ersetzen: flaggen.has('ersetzen'),
             lokal,
@@ -1320,7 +1322,9 @@ function istModellFehler(fehler) {
  */
 function naechsterSchritt(fehler) {
     if (fehler instanceof SkillMehrdeutig)
-        return `Quelle eingrenzen: hmgr link ${fehler.name} --quelle <teilstring einer der genannten Quellen>`;
+        return fehler.nurEineQuelle
+            ? `Fassung wählen: hmgr link ${fehler.name} --pfad <einer der genannten Pfade>`
+            : `Quelle eingrenzen: hmgr link ${fehler.name} --quelle <teilstring einer der genannten Quellen>`;
     if (fehler instanceof SkillUnbekannt)
         return 'Erst die Quelle hinzufügen: hmgr source add <url|pfad>. hmgr source list zeigt die bekannten Quellen.';
     if (fehler instanceof NameBelegt)

package/dist/gui/main.js

@@ -228,6 +228,7 @@ function registriereIpc() {
                     ...(skill.eigenerKontext === undefined ? {} : { eigenerKontext: skill.eigenerKontext }),
                     ...(skill.argumentHinweis === undefined ? {} : { argumentHinweis: skill.argumentHinweis }),
                     ...(skill.geaendert === undefined ? {} : { geaendert: skill.geaendert }),
+                    ...(skill.jeHarness === undefined ? {} : { jeHarness: skill.jeHarness }),
                     quelleText: quelleAlsText(eintrag.quelle),
                     quelleName: quelleName(eintrag.quelle),
                     quelleSchluessel: quelleSchluessel(eintrag.quelle),
@@ -886,6 +887,8 @@ function fensterOeffnen() {
               var dskBundleBoxSichtbar = false;
               var dskBundleText = null;
               var dskBundleZuVorher = null, dskBundleKoerperText = null;
+              // E121: ein Name mit mehreren Fassungen in der Quelle steht einmal, mit Vermerk statt Pfad.
+              var dskMehrfachAnzahl = null, dskMehrfachText = null;
               // Aufklappbereich je Zeile (E92): zu vor dem Klick, danach sichtbar mit der ungekürzten
               // Beschreibung; die Checkbox bleibt unberührt, der Dialog offen.
               var dskKoerperVorher = null;
@@ -920,6 +923,10 @@ function fensterOeffnen() {
                 dskAufklapp?.click();
                 dskKoerper?.querySelector('p')?.click();
                 dskAufklappFreiAngehakt = dskEingabe?.checked ?? null;
+                var dskMehrfach = Array.from(document.querySelectorAll('#dsk-liste .wahlzeile'))
+                  .filter((z) => z.querySelector('b')?.textContent === 'zmehrfach');
+                dskMehrfachAnzahl = dskMehrfach.length;
+                dskMehrfachText = dskMehrfach[0]?.querySelector('.mono')?.textContent ?? null;
                 dskBundleBoxSichtbar = document.getElementById('dsk-bundlebox')?.hidden === false;
                 dskBundleText = document.querySelector('#dsk-bundles .wahlzeile')?.textContent
                   ?.replace(/\\s+/g, ' ').trim() ?? null;
@@ -1283,6 +1290,8 @@ function fensterOeffnen() {
                 katalogDetails,
                 katalogMarkenWarnend,
                 dskMarken,
+                dskMehrfachAnzahl,
+                dskMehrfachText,
                 dskKoerperVorher,
                 dskKoerperNachher,
                 dskKoerperText,

package/dist/gui/renderer/renderer.js

@@ -813,7 +813,7 @@
   /** Skill zu einem Mitglied einer Definition aus dem Skill-Katalog (E114 L1): gleiche Quelle, gleicher
       Pfad. null, wenn die Quelle (noch) nicht eingerichtet oder nicht lesbar ist. */
   function bundleMitgliedSkill(m) {
-    return SKILLS.filter(function (s) { return s.quelleSchluessel === m.quelleSchluessel && s.pfad === m.pfad; })[0] || null;
+    return SKILLS.filter(function (s) { return s.quelleSchluessel === m.quelleSchluessel && (s.pfad === m.pfad || (s.jeHarness || []).indexOf(m.pfad) > -1); })[0] || null;
   }
 
   /** Skill eines nicht verlinkten Mitglieds über seinen Namen, gesucht unter den Mitgliedern der
@@ -2274,7 +2274,8 @@
       // Skill-Ordner berührt. Nicht der Pull-Zeitpunkt — der steht als „Zuletzt geprüft" in der
       // Update-Ansicht und wäre für alle Skills einer Quelle derselbe.
       var geaendert = datumDeutsch(skill.geaendert);
-      var nachRef = ' · Ref ' + skill.ref + (geaendert ? ' · geändert ' + geaendert : '');
+      var nachRef = ' · Ref ' + skill.ref + (geaendert ? ' · geändert ' + geaendert : '')
+        + (skill.jeHarness ? ' · ' + JE_HARNESS_VERMERK : '');
       if (herkunftQuelle) {
         herkunft.appendChild(quelleLinkElement(herkunftQuelle));
         herkunft.appendChild(e('b', null, nachRef));
@@ -2341,7 +2342,8 @@
     var sichtbar = 0;
     document.querySelectorAll('#katalog .zeile').forEach(function (li) {
       var skill = SKILLS[+li.dataset.index];
-      var passtSuche = !suche || suchform(skill.name).indexOf(suche) > -1 || suchform(skill.pfad).indexOf(suche) > -1;
+      var passtSuche = !suche || suchform(skill.name).indexOf(suche) > -1 || suchform(skill.pfad).indexOf(suche) > -1
+        || (skill.jeHarness || []).some(function (p) { return suchform(p).indexOf(suche) > -1; });
       var passtFilter = quellenFilter === 'alle' || skill.quelleSchluessel === quellenFilter;
       var an = passtSuche && passtFilter;
       li.hidden = !an;
@@ -2581,9 +2583,13 @@
   /** Quelle · [Pfad ·] Ref für eine Skill-Karte im „Skills hinzufügen"-Dialog (F106): der Pfad
       unterscheidet Skills, die unter demselben Namen mehrfach im selben Repo liegen (z. B. je
       Harness ein eigener Ordner). Ein Wurzel-Skill hat pfad === '' und zeigt kein Pfad-Segment. */
+  var JE_HARNESS_VERMERK = 'je Harness eigene Fassung';
+
   function skillQuelleBeschriftung(skill) {
     var teile = [skill.quelleName];
-    if (skill.pfad) teile.push(skill.pfad);
+    // Mehrfach in der Quelle, je Harness eine eigene Fassung (E121): der Kern löst beim Verlinken auf.
+    if (skill.jeHarness) teile.push(JE_HARNESS_VERMERK);
+    else if (skill.pfad) teile.push(skill.pfad);
     teile.push('Ref ' + skill.ref);
     return teile.join(' · ');
   }

package/dist/kern/anwendungsfaelle.js

@@ -861,10 +861,10 @@ export class Anwendungsfaelle {
                 ergebnis.push({
                     quelle,
                     ref,
-                    skills: skills.map((skill) => {
+                    skills: this.fassungenZusammenfassen(skills.map((skill) => {
                         const geaendert = daten.get(skill.pfad);
                         return geaendert === undefined ? skill : { ...skill, geaendert };
-                    }),
+                    })),
                 });
             }
             catch (fehler) {
@@ -873,6 +873,39 @@ export class Anwendungsfaelle {
         }
         return ergebnis;
     }
+    /**
+     * Katalog-Zusammenfassung (E121): Ein Name, der in einer Quelle mehrfach vorkommt und mindestens
+     * einmal unmittelbar in einem Harness-Skill-Ordner liegt, erscheint einmal, mit `jeHarness`. Als
+     * Vertreter dient die Fassung im ersten passenden Harness-Ordner (Reihenfolge der Harnesses),
+     * sonst die erste. Alle anderen Namen bleiben unverändert, ebenso die Reihenfolge.
+     */
+    fassungenZusammenfassen(skills) {
+        const ordner = this.p.harnesses.map((h) => `${h.quellOrdner()}/`);
+        const direkt = (s, o) => s.pfad.startsWith(o) && !s.pfad.slice(o.length).includes('/');
+        const gruppen = new Map();
+        for (const s of skills)
+            gruppen.set(s.name, [...(gruppen.get(s.name) ?? []), s]);
+        const ergebnis = [];
+        for (const s of skills) {
+            const gruppe = gruppen.get(s.name);
+            if (gruppe.length < 2 || !gruppe.some((g) => ordner.some((o) => direkt(g, o)))) {
+                ergebnis.push(s);
+                continue;
+            }
+            if (gruppe[0] !== s)
+                continue; // Vertreter steht an der Stelle der ersten Fassung
+            let vertreter = gruppe[0];
+            for (const o of ordner) {
+                const treffer = gruppe.find((g) => direkt(g, o));
+                if (treffer !== undefined) {
+                    vertreter = treffer;
+                    break;
+                }
+            }
+            ergebnis.push({ ...vertreter, jeHarness: gruppe.map((g) => g.pfad) });
+        }
+        return ergebnis;
+    }
     /** Alle Marketplaces der bekannten Quellen, für `hmgr plugin list`. */
     async marketplaces() {
         const zustand = await this.p.zustand.lesen();
@@ -1566,7 +1599,7 @@ export class Anwendungsfaelle {
         throw new Error(`Mehrere Quellen passen auf „${hinweis}", bitte eingrenzen:\n${zeilen(treffer)}`);
     }
     /** Skill über alle Quellen suchen. Mehrere Treffer sind nur mit Quellenhinweis erlaubt. */
-    async skillFinden(name, quelleHinweis) {
+    async skillFinden(name, quelleHinweis, wahl = {}) {
         const zustand = await this.p.zustand.lesen();
         const funde = [];
         for (const quelle of zustand.quellen) {
@@ -1574,16 +1607,33 @@ export class Anwendungsfaelle {
                 continue;
             const ref = await this.p.quellen.standardRef(quelle);
             const skills = await this.p.quellen.skills(quelle, ref);
-            for (const skill of skills)
-                if (skill.name === name)
-                    funde.push({ quelle, ref, skill });
+            for (const skill of Anwendungsfaelle.skillTreffer(skills, name, wahl))
+                funde.push({ quelle, ref, skill });
         }
         if (funde.length === 0)
             throw new SkillUnbekannt(name);
         if (funde.length > 1)
-            throw new SkillMehrdeutig(name, funde.map((f) => f.quelle));
+            throw new SkillMehrdeutig(name, funde.map((f) => ({ quelle: f.quelle, pfad: f.skill.pfad })));
         return funde[0];
     }
+    /**
+     * Die Skills einer Quelle zu einem Namen (E121). Mit `pfad` zählt nur der Skill mit genau diesem
+     * Pfad. Sonst gewinnt bei mehreren Fassungen die eine, die unmittelbar im Skill-Ordner des
+     * Harness liegt (`<quellOrdner>/<ordner>`, eine Ebene); gibt es keine solche oder mehrere,
+     * bleiben alle, und der Aufrufer meldet die Mehrdeutigkeit.
+     */
+    static skillTreffer(skills, name, wahl) {
+        const gleichnamig = skills.filter((s) => s.name === name);
+        if (wahl.pfad !== undefined) {
+            const pfad = wahl.pfad.replace(/^\.?\/+|\/+$/g, '');
+            return gleichnamig.filter((s) => s.pfad === pfad);
+        }
+        if (gleichnamig.length < 2 || wahl.quellOrdner === undefined)
+            return gleichnamig;
+        const praefix = `${wahl.quellOrdner}/`;
+        const direkt = gleichnamig.filter((s) => s.pfad.startsWith(praefix) && !s.pfad.slice(praefix.length).includes('/'));
+        return direkt.length === 1 ? direkt : gleichnamig;
+    }
     /** Checkout anlegen oder erweitern, Ziel vorbereiten, Link setzen. Ohne Zeiger-Arbeit. */
     async linkAnlegen(harness, ziel, fund, ersetzen) {
         if (!harness.orte().includes(ziel.ort.art))
@@ -1627,8 +1677,12 @@ export class Anwendungsfaelle {
         if (!harness.orte().includes(args.ziel.ort.art))
             throw new OrtNichtUnterstuetzt(harness.name, args.ziel.ort.art);
         const version = args.version;
+        const wahl = {
+            quellOrdner: harness.quellOrdner(),
+            ...(args.pfad === undefined ? {} : { pfad: args.pfad }),
+        };
         if (version === undefined) {
-            const fund = await this.skillFinden(args.skill, args.quelle);
+            const fund = await this.skillFinden(args.skill, args.quelle, wahl);
             const ergebnis = await this.linkAusFund(harness, args.ziel, fund, args.ersetzen, args.lokal);
             return Anwendungsfaelle.hinweisAnhaengen(ergebnis, await this.bundleMitgliedZurueckholen(args.ziel, fund));
         }
@@ -1640,7 +1694,7 @@ export class Anwendungsfaelle {
         // Eine Versionseinschränkung schreibt immer geteilt (siehe EinschraenkungOhneZeiger oben), das
         // trifft die Sperre also ausnahmslos, solange sie steht (E57).
         await this.zeigerSchreibenPruefen(args.ziel, args.lokal);
-        const fund = await this.fundAusZeiger(args.skill, version, args.quelle);
+        const fund = await this.fundAusZeiger(args.skill, version, args.quelle, wahl);
         const link = await this.linkAnlegen(harness, args.ziel, fund, args.ersetzen);
         await this.zeigerErgaenzen(zeigerPfad, fund, version);
         const hinweis = await this.harnessHinweis(harness, args.ziel.ort);
@@ -1957,9 +2011,9 @@ export class Anwendungsfaelle {
      * gilt der Text als genauer Ref-Name gegen alle Refs, damit Tags und Branches ohne
      * Versions-Schema erreichbar bleiben. Nie auf den Standard-Ref ausweichen (B8).
      */
-    async fundAusZeiger(name, einschraenkung, quelleHinweis) {
+    async fundAusZeiger(name, einschraenkung, quelleHinweis, wahl = {}) {
         if (einschraenkung === null)
-            return await this.skillFinden(name, quelleHinweis);
+            return await this.skillFinden(name, quelleHinweis, wahl);
         const zustand = await this.p.zustand.lesen();
         const quellen = zustand.quellen.filter((q) => quellePasst(q, quelleHinweis));
         for (const quelle of quellen) {
@@ -1968,7 +2022,7 @@ export class Anwendungsfaelle {
             const ref = passenderRef(tags, einschraenkung);
             if (ref === null)
                 continue;
-            const skill = (await this.p.quellen.skills(quelle, ref)).find((s) => s.name === name);
+            const skill = Anwendungsfaelle.skillTreffer(await this.p.quellen.skills(quelle, ref), name, wahl)[0];
             if (skill)
                 return { quelle, ref, skill };
         }
@@ -1976,7 +2030,7 @@ export class Anwendungsfaelle {
             const refs = await this.p.quellen.refs(quelle).catch(() => []);
             if (!refs.includes(einschraenkung))
                 continue;
-            const skill = (await this.p.quellen.skills(quelle, einschraenkung)).find((s) => s.name === name);
+            const skill = Anwendungsfaelle.skillTreffer(await this.p.quellen.skills(quelle, einschraenkung), name, wahl)[0];
             if (skill)
                 return { quelle, ref: einschraenkung, skill };
         }
@@ -2053,7 +2107,7 @@ export class Anwendungsfaelle {
             }
             for (const [name, einschraenkung] of zeiger.skills) {
                 try {
-                    const fund = await this.fundAusZeiger(name, einschraenkung);
+                    const fund = await this.fundAusZeiger(name, einschraenkung, undefined, { quellOrdner: harness.quellOrdner() });
                     const gefunden = eintraege.find((e) => e.art === 'link' && e.link.name === name);
                     // Ein eigener Link auf einen anderen Ref weicht ab und wird umgelegt (E33). Das trifft
                     // die Einschränkung, die inzwischen einen höheren Tag findet.

package/dist/kern/modell.js

@@ -338,10 +338,24 @@ export class LinkAnlegenFehlgeschlagen extends Error {
 export class SkillMehrdeutig extends Error {
     name;
     quellen;
-    constructor(name, quellen) {
-        super(`Skill „${name}" liegt in mehreren Quellen: ${quellen.map(quelleSchluessel).join(', ')}`);
+    funde;
+    /** Die Mehrdeutigkeit kommt aus einer einzigen Quelle: `--pfad` hilft, nicht `--quelle` (E121). */
+    nurEineQuelle;
+    constructor(name, funde) {
+        const quellen = [];
+        for (const f of funde)
+            if (!quellen.some((q) => quelleSchluessel(q) === quelleSchluessel(f.quelle)))
+                quellen.push(f.quelle);
+        const zeilen = funde
+            .map((f) => `  ${quelleSchluessel(f.quelle)}: ${f.pfad === '' ? '(Repo-Wurzel)' : f.pfad}`)
+            .join('\n');
+        super(quellen.length === 1
+            ? `Skill „${name}" liegt in der Quelle ${quelleSchluessel(quellen[0])} mehrfach:\n${zeilen}`
+            : `Skill „${name}" liegt in mehreren Quellen:\n${zeilen}`);
         this.name = name;
         this.quellen = quellen;
+        this.funde = funde;
+        this.nurEineQuelle = quellen.length === 1;
     }
 }
 export class SkillUnbekannt extends Error {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hmgr",
-  "version": "0.0.51",
+  "version": "0.0.52",
   "description": "Harness Manager: Skills und Plugins für AI-Harnesses verwalten",
   "license": "MIT",
   "author": "Tim Kaufmann",