@conciso/design-system-mcp 2.6.0 → 2.7.0

package/README.md

@@ -34,6 +34,7 @@ Beim Verbinden gibt der Server dem Assistenten außerdem feste Regeln mit:
 3. Nur Inputs und Outputs verwenden, die `docs-show` liefert. Vorher nachsehen, nie raten.
 4. Bei Fragen zur Einrichtung die Storybook-Seite „Einrichtung“ lesen.
 5. Für Auswahl- und Gestaltungsfragen zusätzlich die Verwendungsguidance der Komponente heranziehen, sonst über `docs-list` die passende „Verwendung“-Seite suchen.
+6. Mehrere Doku-Seiten in `docs-list` heißen gleich (meist „Übersicht“ oder „Verwendung“), unterscheidbar nur über ihre ID (Schema „`<pfad>--<name>`“).
 
 Weitere Eigenschaften:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@conciso/design-system-mcp",
-  "version": "2.6.0",
+  "version": "2.7.0",
   "description": "MCP-Server für Consumer des Conciso Design System, beantwortet docs-list, docs-show und docs-show-story über stdio aus einem mitgelieferten Storybook-Snapshot, ohne Netzzugriff.",
   "license": "MIT",
   "type": "module",

package/src/instructions.mjs

@@ -13,6 +13,14 @@ import { STORYBOOK_MCP_INSTRUCTIONS } from '@storybook/mcp';
  */
 export const EINRICHTUNG_DOC_ID = 'grundlagen-einrichtung--übersicht';
 
+/**
+ * Kernsatz der Regel zum ID-Schema in docs-list: Das Doku-Manifest (Schema v1) kennt kein
+ * `title`-Feld, `formatDocLine` fällt für jeden Eintrag auf `doc.name` zurück, viele MDX-Seiten
+ * heißen deshalb gleich „Übersicht“ oder „Verwendung“. Exportiert, damit ein Test genau diesen
+ * Satz in den ausgelieferten `instructions` prüfen kann, ohne ihn ein zweites Mal abzutippen.
+ */
+export const DOCS_LIST_ID_SCHEME_HINT = 'Unterscheidbar sind sie nur über ihre ID, Schema „<pfad>--<name>“';
+
 const OWN_INSTRUCTIONS = `## Conciso Design System
 
 Feste Regeln für die Angular-Lib „@conciso/design-system-angular“:
@@ -21,7 +29,8 @@ Feste Regeln für die Angular-Lib „@conciso/design-system-angular“:
 2. Kein eigenes CSS für DS-Komponenten schreiben und keine CSS-Klassen erfinden.
 3. Nur Inputs und Outputs verwenden, die docs-show für die jeweilige Komponente liefert. Vorher nachsehen, nie raten.
 4. Bei Fragen zur Einrichtung docs-show mit der ID „${EINRICHTUNG_DOC_ID}“ aufrufen (Storybook-Seite „Einrichtung“).
-5. Für Auswahl- und Gestaltungsfragen (welche Komponente, welche Variante, wo platzieren) zusätzlich die Verwendungsguidance heranziehen: Sie steht, wenn vorhanden, in der docs-show-Antwort der Komponente im Abschnitt „Docs“. Fehlt dieser Abschnitt, über docs-list nach einer Seite „Verwendung“ der Komponentengruppe suchen und sie mit docs-show laden.`;
+5. Für Auswahl- und Gestaltungsfragen (welche Komponente, welche Variante, wo platzieren) zusätzlich die Verwendungsguidance heranziehen: Sie steht, wenn vorhanden, in der docs-show-Antwort der Komponente im Abschnitt „Docs“. Fehlt dieser Abschnitt, über docs-list nach einer Seite „Verwendung“ der Komponentengruppe suchen und sie mit docs-show laden.
+6. In docs-list teilen sich mehrere Doku-Seiten denselben Anzeigenamen (meist „Übersicht“ oder „Verwendung“). ${DOCS_LIST_ID_SCHEME_HINT} (Beispiel: „grundlagen-einrichtung--übersicht“). Bei einer Frage zu einem bestimmten Thema den Pfadteil vor den beiden Bindestrichen prüfen, nicht den Anzeigenamen.`;
 
 /**
  * Anzahl der oben nummerierten Regeln in OWN_INSTRUCTIONS. Exportiert, damit ein Test sie gegen