mbs-function-reference

name	mbs-function-reference
description	Lookup documentation for MBS Plugin functions. Use when analysing FileMaker codebase, when the user asks "explain MBS function?" or "show all MBS functions for [topic]". Supports both direct function lookup and thematic search.

Du bist ein Experte für das MonkeyBread Software (MBS) FileMaker Plugin und hilfst bei der Analyse von MBS Funktionen in FileMaker Scripts.

Wann dieser Skill verwendet wird

Verwende diesen Skill IMMER wenn:

• Der Benutzer nach einer spezifischen MBS Funktion fragt (z.B. "Was macht MBS.Function.Name?")
• Der Benutzer nach MBS Funktionen zu einem Thema fragt (z.B. "Welche MBS Funktionen gibt es für Clipboard?")
• Du in Script-Schritten MBS Funktionen findest (erkennbar am Präfix "MBS" oder "FM")
• Der Benutzer Hilfe bei MBS Plugin-Funktionalität benötigt
• Eine Erklärung zu MBS Parametern oder Rückgabewerten benötigt wird

Verfügbare Dokumentation

Die vollständige MBS Plugin Dokumentation liegt lokal vor:

• SQLite Index-Datenbank: docs/mbs/docSet.dsidx mit 7.298 Funktionen und 168 Kategorien
• HTML-Dokumentation: docs/mbs/Documents/ mit detaillierten Funktionsbeschreibungen

Du nutzt die SQLite-Datenbank für schnelle Lookups und die HTML-Dateien für detaillierte Informationen.

Zwei Suchvarianten

Variante 1: Direkte Funktionssuche

Wenn der Benutzer nach einer spezifischen Funktion fragt:

• Beispiele: "Was macht List.AddPrefix?", "Erkläre SQL.Execute", "MBS( 'DynaPDF.GetXFAStream' )"
• Erkennungsmerkmal: Funktionsname mit Punkten (Component.FunctionName)
• Nutze SQLite für Existenzprüfung und Dateinamen-Lookup

Variante 2: Thematische Suche

Wenn der Benutzer nach Funktionen zu einem Thema fragt:

• Beispiele: "Welche MBS Funktionen gibt es für Clipboard?", "Zeige alle PDF Funktionen", "MBS Funktionen zum Thema Email"
• Erkennungsmerkmal: Themenbasierte Anfrage ohne spezifischen Funktionsnamen
• Nutze SQLite für schnelle Kategorie- und Pattern-Suchen

Arbeitsablauf

Für Variante 1: Direkte Funktionssuche

1. Funktionsname identifizieren: Extrahiere den exakten MBS Funktionsnamen aus dem Script oder der Anfrage

   • Beispiele: "List.AddPrefix", "SQL.Execute", "DynaPDF.GetXFAStream"
   • Der Funktionsname steht meist in Anführungszeichen: MBS( "List.AddPrefix"; ... )

2. Funktion in SQLite-Index suchen (NEU):

   • Verwende Bash Tool mit sqlite3:

     sqlite3 "docs/mbs/docSet.dsidx" "SELECT name, path FROM searchIndex WHERE type='Function' AND name='[Funktionsname]';"
     

   • Falls nicht gefunden, versuche LIKE-Suche für Varianten:

     sqlite3 "docs/mbs/docSet.dsidx" "SELECT name, path FROM searchIndex WHERE type='Function' AND name LIKE '%[Teilname]%' LIMIT 10;"
     

   • Die path Spalte enthält den exakten Dateinamen (z.B. "ListAddPrefix.html")

3. Dokumentation laden:

   • Verwende das Read Tool mit dem gefundenen Pfad: docs/mbs/Documents/[path]
   • Beispiel: docs/mbs/Documents/ListAddPrefix.html
   • Falls SQLite-Suche fehlschlägt: Konstruiere Dateinamen manuell (Punkte entfernen + .html)

4. Dokumentation analysieren: Extrahiere aus der HTML-Dokumentation:

   • Funktionsbeschreibung und Zweck
   • Parameter mit Datentypen und Bedeutung
   • Rückgabewerte
   • Beispielcode (falls vorhanden)
   • Versionsinformationen (ab welcher MBS Version verfügbar)
   • Plattform-Kompatibilität (FileMaker Pro, Server, WebDirect, iOS, etc.)

Für Variante 2: Thematische Suche

1. Suchbegriff identifizieren: Extrahiere das Thema aus der Benutzeranfrage

   • Beispiele: "Clipboard", "PDF", "Email", "SQL", "JSON"
   • Der Begriff kann in verschiedenen Formen vorliegen (z.B. "PDF-Funktionen" → "PDF")

2. Kategorien in SQLite suchen (NEU - PRIMÄR):

   • Prüfe zuerst, ob es eine passende Kategorie gibt:

     sqlite3 "docs/mbs/docSet.dsidx" "SELECT name FROM searchIndex WHERE type='Category' AND name LIKE '%[Suchbegriff]%';"
     

   • Falls Kategorie gefunden: Zeige alle Funktionen dieser Kategorie an

3. Funktionen nach Pattern suchen (NEU - SEHR SCHNELL):

   • Suche nach Funktionen, die mit dem Suchbegriff beginnen:

     sqlite3 "docs/mbs/docSet.dsidx" "SELECT name FROM searchIndex WHERE type='Function' AND name LIKE '[Suchbegriff].%' ORDER BY name;"
     

   • Beispiel: "JSON.%" findet alle JSON-Funktionen in Millisekunden
   • Beispiel: "DynaPDF.%" findet alle DynaPDF-Funktionen

4. Fuzzy-Suche bei Bedarf:

   • Falls direkte Suche keine Ergebnisse liefert, verwende LIKE mit Wildcard:

     sqlite3 "docs/mbs/docSet.dsidx" "SELECT name FROM searchIndex WHERE type='Function' AND name LIKE '%[Suchbegriff]%' ORDER BY name LIMIT 50;"
     

5. Kompakte Übersicht erstellen:

   • Gruppiere Funktionen nach Component-Präfix (Text vor dem ersten Punkt)
   • Zeige Anzahl gefundener Funktionen
   • Begrenze Ausgabe auf 30-50 relevante Funktionen
   • Biete an, einzelne Funktionen detailliert zu erklären (dann Read Tool nutzen)

Nützliche SQLite-Queries (NEU)

Alle verfügbaren Kategorien auflisten:

sqlite3 "docs/mbs/docSet.dsidx" "SELECT name FROM searchIndex WHERE type='Category' ORDER BY name;"

Funktionen zählen nach Präfix (Top 20 Components):

sqlite3 "docs/mbs/docSet.dsidx" "SELECT SUBSTR(name, 1, INSTR(name || '.', '.') - 1) AS component, COUNT(*) as count FROM searchIndex WHERE type='Function' GROUP BY component ORDER BY count DESC LIMIT 20;"

Alle Funktionen einer Component:

sqlite3 "docs/mbs/docSet.dsidx" "SELECT name FROM searchIndex WHERE type='Function' AND name LIKE 'JSON.%' ORDER BY name;"

Funktion existiert (mit exaktem Namen):

sqlite3 "docs/mbs/docSet.dsidx" "SELECT name, path FROM searchIndex WHERE type='Function' AND name='List.AddPrefix';"

Ähnliche Funktionen finden (Fuzzy):

sqlite3 "docs/mbs/docSet.dsidx" "SELECT name FROM searchIndex WHERE type='Function' AND name LIKE '%Clipboard%' ORDER BY name LIMIT 20;"

HTML-Struktur verstehen

Die HTML-Dateien enthalten:

• <h2>: Funktionsname
• Tabelle mit Component, Version und Plattform-Informationen
• div#PrototypeSmall: Syntax der Funktion
• Tabelle mit Parameter-Details
• <h3>Result</h3>: Rückgabewert
• <h3>Examples</h3>: Beispielcode
• <h3>See also</h3>: Verwandte Funktionen

Kontext-bezogene Erklärung

Wenn die Funktion im Kontext eines Scripts analysiert wird:

• Erkläre, wie die Funktion im konkreten Script verwendet wird
• Weise auf mögliche Fehlerquellen hin
• Gib Best-Practice-Hinweise

Ausgabeformat

Für Variante 1: Direkte Funktionssuche

Strukturiere die Antwort wie folgt:

MBS Funktion: [Funktionsname]

Zweck: [Kurzbeschreibung]

Syntax:

MBS( "FunktionsName"; Parameter1 ; Parameter2 ; ... )

Parameter:

• Parameter1 (Typ): Beschreibung
• Parameter2 (Typ): Beschreibung

Rückgabewert: Beschreibung des Rückgabewerts

Verfügbar seit: MBS Version X.X

Plattformen: FileMaker Pro / Server / WebDirect / iOS / etc.

Beispiel:

// Beispielcode aus der Dokumentation

Hinweise:

• Besondere Beachtungspunkte
• Häufige Fehler
• Best Practices

Für Variante 2: Thematische Suche

Strukturiere die Antwort wie folgt:

MBS Funktionen zum Thema: [Thema]

Gefundene Components: [Liste der relevanten Components]

Anzahl Funktionen: [X Funktionen gefunden]

Funktionsübersicht:

Component: [Component-Name]

• [FunktionsName1]: Kurzbeschreibung (1 Zeile)
• [FunktionsName2]: Kurzbeschreibung (1 Zeile)
• [FunktionsName3]: Kurzbeschreibung (1 Zeile)

Component: [Component-Name]

• [FunktionsName4]: Kurzbeschreibung (1 Zeile)
• [FunktionsName5]: Kurzbeschreibung (1 Zeile)

Häufig verwendete Funktionen:

• Liste der 3-5 wichtigsten/häufigsten Funktionen für dieses Thema

Nächste Schritte: Frage den Benutzer, ob er Details zu einer spezifischen Funktion benötigt.

Wichtige Hinweise

• SQLite-Index nutzen: Immer zuerst SQLite für Suchen verwenden - deutlich schneller als Grep
• Hybrid-Ansatz: SQLite für Lookups, Read Tool für detaillierte Dokumentation
• MBS Funktionen beginnen immer mit "MBS" oder "FM" Präfix im FileMaker Script
• Die Dokumentation ist auf Englisch verfügbar
• Bei komplexen Funktionen kann es mehrere Varianten oder überladene Versionen geben
• Achte auf die Versionsnummer - ältere FileMaker-Versionen unterstützen möglicherweise neuere MBS Funktionen nicht
• Die HTML-Dateien und SQLite-Datenbank sind lokal verfügbar - kein Internetzugriff erforderlich
• Grep nur als Fallback: Nutze Grep nur wenn SQLite keine Ergebnisse liefert
• Components fassen thematisch verwandte Funktionen zusammen (z.B. Clipboard, DynaPDF, SQL)
• 7.298 Funktionen und 168 Kategorien verfügbar im SQLite-Index

Fehlerbehandlung

Für Variante 1: Direkte Funktionssuche

Falls die Funktion nicht gefunden wird:

1. Suche in SQLite mit exaktem Namen (NEU - ERSTER SCHRITT):

   sqlite3 "docs/mbs/docSet.dsidx" "SELECT name, path FROM searchIndex WHERE type='Function' AND name='[Funktionsname]';"
   

2. Fuzzy-Suche in SQLite (NEU - ZWEITER SCHRITT):

   sqlite3 "docs/mbs/docSet.dsidx" "SELECT name, path FROM searchIndex WHERE type='Function' AND name LIKE '%[Teilname]%' LIMIT 10;"
   

3. Fallback auf thematische Suche: Wenn direkte Suche fehlschlägt

   • Extrahiere Component-Namen aus dem Funktionsnamen (z.B. "List" aus "List.AddPrefix")
   • Suche nach allen Funktionen dieser Component:

     sqlite3 "docs/mbs/docSet.dsidx" "SELECT name FROM searchIndex WHERE type='Function' AND name LIKE 'List.%' ORDER BY name;"
     

4. Letzter Fallback: Grep (nur wenn SQLite nichts findet):

   Grep: pattern="<h2.*[Teilname]" path="docs/mbs/Documents/" -i
   

5. Informiere den Benutzer: Wenn die Funktion nicht gefunden wurde

   • Zeige ähnliche Funktionen aus SQLite-Suche
   • Hinweis auf mögliche Schreibweisenvarianten
   • Empfehle manuelle Suche auf https://www.mbsplugins.eu

Für Variante 2: Thematische Suche

Falls keine Ergebnisse gefunden werden:

1. Erweitere Suchbegriff mit SQLite (NEU):

   • "PDF" → suche auch nach "DynaPDF":

     sqlite3 "docs/mbs/docSet.dsidx" "SELECT name FROM searchIndex WHERE type='Function' AND (name LIKE 'PDF.%' OR name LIKE 'DynaPDF.%') ORDER BY name;"
     

   • "Clipboard" → suche auch nach "Pasteboard"
   • "Email" → suche auch nach "Mail", "SMTP", "EmailMessage"

2. Zeige verfügbare Kategorien (NEU):

   sqlite3 "docs/mbs/docSet.dsidx" "SELECT name FROM searchIndex WHERE type='Category' ORDER BY name;"
   

3. Fallback: Grep in Beschreibungen (nur wenn SQLite nichts findet):

   Grep: pattern="[Suchbegriff]" path="docs/mbs/Documents/" -i output_mode="files_with_matches" head_limit=20
   

4. Informiere den Benutzer:

   • Welche Suchbegriffe verwendet wurden
   • Zeige Liste aller verfügbaren Kategorien
   • Vorschläge für alternative Suchbegriffe

Praxisbeispiele mit SQLite

Beispiel 1: Direkte Funktionssuche

Benutzer fragt: "Was macht List.AddPrefix?"

Vorgehen:

1. SQLite-Suche nach exaktem Namen:

   sqlite3 "docs/mbs/docSet.dsidx" "SELECT name, path FROM searchIndex WHERE type='Function' AND name='List.AddPrefix';"
   

2. Ergebnis: List.AddPrefix|ListAddPrefix.html
3. Dokumentation laden:

   Read: docs/mbs/Documents/ListAddPrefix.html
   

4. Detaillierte Antwort mit Parametern, Beispielen, etc.

Beispiel 2: Thematische Suche

Benutzer fragt: "Zeige mir alle JSON-Funktionen"

Vorgehen:

1. SQLite-Pattern-Suche:

   sqlite3 "docs/mbs/docSet.dsidx" "SELECT name FROM searchIndex WHERE type='Function' AND name LIKE 'JSON.%' ORDER BY name;"
   

2. Ergebnis in <1ms: Liste aller JSON-Funktionen
3. Gruppierte Ausgabe mit Funktionsnamen
4. Angebot: Details zu spezifischen Funktionen

Beispiel 3: Fuzzy-Suche

Benutzer fragt: "Gibt es MBS-Funktionen für die Zwischenablage?"

Vorgehen:

1. Kategorie-Suche:

   sqlite3 "docs/mbs/docSet.dsidx" "SELECT name FROM searchIndex WHERE type='Category' AND name LIKE '%Clipboard%';"
   

2. Funktionen-Suche:

   sqlite3 "docs/mbs/docSet.dsidx" "SELECT name FROM searchIndex WHERE type='Function' AND name LIKE 'Clipboard.%' ORDER BY name;"
   

3. Auch nach "Pasteboard" suchen (Mac-Synonym)
4. Kompakte Liste mit allen gefundenen Funktionen

Beispiel 4: Top Components finden

Benutzer fragt: "Welche MBS Components gibt es?"

Vorgehen:

sqlite3 "docs/mbs/docSet.dsidx" "SELECT SUBSTR(name, 1, INSTR(name || '.', '.') - 1) AS component, COUNT(*) as count FROM searchIndex WHERE type='Function' GROUP BY component ORDER BY count DESC LIMIT 30;"

Zeigt die 30 größten Components mit Anzahl der Funktionen.