profile

Verwaltet das gemeinsame Apothem-Profil.

profile ist eine Befehlsgruppe mit vier Unterbefehlen: init, show, set und edit. Das gemeinsame Profil ist die einzige maßgebliche Quelle, die jeder Harness-Adapter in seine native Konfiguration materialisiert.

ÜbersichtCopy Anchor Link

apothem profile init [--profile PATH] [--force]
                     [--quiet|-q] [--verbose|-v]
                     [--format plain|json] [--json] [--no-color]
apothem profile show [--profile PATH] [--quiet|-q] [--verbose|-v]
                     [--format plain|json] [--json] [--no-color]
apothem profile set KEY VALUE
                     [--profile PATH] [--quiet|-q] [--verbose|-v]
                     [--format plain|json] [--json] [--no-color]
apothem profile edit [--profile PATH] [--quiet|-q] [--verbose|-v]
                     [--format plain|json] [--json] [--no-color]

Gemeinsame OptionenCopy Anchor Link

Jeder Unterbefehl akzeptiert die folgenden gemeinsamen Optionen.

UnterbefehleCopy Anchor Link

profile initCopy Anchor Link

Erstellt ein schemagültiges, minimales Profilgerüst unter ~/.config/apothem/profile.yaml oder --profile PATH. Vorhandene Dateien bleiben erhalten, sofern nicht --force angegeben wird.

Die erste Zeile des Gerüsts ist eine yaml-language-server-Modeline, die die $id des Profilschemas nennt, https://apothem.ahmedgad.com/schemas/profile.schema.json. Die Website stellt das mitgelieferte Schema unter dieser Adresse bereit, sodass ein Editor mit YAML-Sprachunterstützung das Profil validiert, während Sie es bearbeiten. Jedes mitgelieferte Schema unter src/apothem/schemas/ wird auf dieselbe Weise unter https://apothem.ahmedgad.com/schemas/<file> bereitgestellt.

profile showCopy Anchor Link

Zeigt das validierte, um Standardwerte erweiterte gemeinsame Profil an. Mit --json ist das Dokument das Profil selbst, angeführt von schema_version: der Version des Profilschemas, nach der die Engine es gelesen hat (siehe den JSON-Ausgabevertrag).

profile set KEY VALUECopy Anchor Link

Setzt einen Schlüssel im gemeinsamen Profil. KEY ist ein punktgetrennter Pfad, der in das verschachtelte Profil absteigt (identity.name, preferences.style, enforcement.sprints, harnesses.<harness>.preferences.style); ein einzelner Schlüssel ohne Punkt setzt einen Knoten der obersten Ebene. VALUE wird als wörtliche Zeichenkette gespeichert — bloße Wörter werden nicht umgewandelt (no bleibt "no", 2024-01-01 und 1.0 bleiben Zeichenketten) — mit Ausnahme von true/false (den booleschen Durchsetzungs-Flags) und expliziter [...]/{...}-Listen-/Map-Eingabe. Das vollständig zusammengesetzte Profil wird vor dem Schreiben gegen das Schema validiert; ein ungültiges Setzen wird abgelehnt, und das Profil auf der Festplatte bleibt unverändert.

profile editCopy Anchor Link

Öffnet das gemeinsame Profil im Systemeditor.

ValidierungsfehlerCopy Anchor Link

Jeder Befehl, der das Profil liest, validiert es gegen das mitgelieferte Schema und meldet in einem Durchlauf jedes gefundene Problem, sodass eine einzige Bearbeitung sie alle beheben kann:

• Klartextausgabe nennt das erste Problem vollständig (Field, Reason, Fix und Offending value (redacted): die Eingabe, die fehlgeschlagen ist, wobei geheimnisartige Werte durch <redacted> ersetzt sind; es ist niemals ein vorgeschlagener Ersatz) und listet dann bis zu zehn weitere unter Other problems auf.
• JSON-Ausgabe behält das erste Problem in den Feldern der obersten Ebene des error-Objekts und fügt ein errors-Array mit jedem Problem hinzu (code, field, reason, fix, safe_value).
• Unbekannte Schlüssel geben nur den unerwarteten Schlüssel und seinen geschwärzten Wert wieder, nicht das gesamte Profil.
• Markierungen verwalteter Blöcke. Kein Schlüssel und kein Textwert darf <!-- BEGIN APOTHEM MANAGED BLOCK --> oder <!-- END APOTHEM MANAGED BLOCK --> enthalten. Apothem schreibt diese Markierungen um den Block, den es in Anweisungsdateien verwaltet, und Profiltext landet innerhalb dieses Blocks; eine Markierung darin würde den Block daher teilen. Jedes solche Feld schlägt mit profile.managed_block_marker fehl: field ist sein punktgetrennter Pfad (zum Beispiel rules.2 oder mcp_servers.search.env.SEARCH_MODE), und reason nennt die Markierung. Der Wert selbst wird niemals wiedergegeben (safe_value ist null), da es sich um Anmeldedaten handeln kann.

profile init (und jeder andere Befehl, der ein Profilgerüst anlegt) schreibt schema_version: 1. Ein Profil ohne schema_version wird als Version 1 gelesen.

BeispieleCopy Anchor Link

apothem profile init
apothem profile init --profile ./profile.yaml --force --json
apothem profile show
apothem profile show --json
apothem profile set seriousness SHARED
apothem profile set rules '["Use fake placeholders in examples."]'
apothem profile edit

Exit-CodesCopy Anchor Link

Siehe auchCopy Anchor Link

• apothem install — materialisiert das Profil in einen Harness
• apothem doctor — führt systemweite Installationsdiagnosen aus