doctor

doctor beantwortet eine Frage: Ist diese Installation intakt? Es vergleicht, was auf der Platte liegt, mit dem, was das Manifest als von BMAD+ installiert führt, prüft Konfiguration und Anweisungsdateien, schaut auf die Laufzeiten, die Packs brauchen, und gibt aus, was es findet. Es schreibt nie ins Projekt und kontaktiert nie npm; ob es eine neuere Version gibt, zeigt update-check. Führe es nach einer Installation, nach einem Update oder bei merkwürdigem Verhalten aus.

Syntax#

npx bmad-plus doctor [-d <path>] [-l <code>] [--json] [--verify-python]

Exit-Codes#

Echte Ausgabe#

Aufgezeichnet unmittelbar nach der auf der Seite zu install gezeigten Installation (Core und Design, 0.23.0). Der lesbare Bericht listet nur, was kein einfaches Bestanden ist, plus die Manifest-Zeile und einen Zusammenfassungskasten. „87/87 checks passed“ zählt alle Prüfungen, auch die nicht aufgelisteten bestandenen.

$ npx bmad-plus doctor --directory .\demo-app
T   BMAD+ Doctor v0.23.0
|
*  Manifest found: v0.23.0
|
o  BMAD+ Health Report ---------------------------------------------------------------------------------+
|                                                                                                       |
|  87/87 checks passed                                                                                  |
|  0 error(s), 0 warning(s)                                                                             |
|  Installed: v0.23.0 | Executing CLI: v0.23.0                                                          |
|  Ownership inventory: complete                                                                        |
|  Integrations use host-managed execution; host capabilities were not probed.                          |
|  Optional Nexus process execution requires an explicit plan; executable availability was not probed.  |
|                                                                                                       |
+-------------------------------------------------------------------------------------------------------+
|
•  Published version is not checked here. Use `bmad-plus update-check --json` to check npm.
|
—  Installation checks passed.

Was geprüft wird#

Jede Prüfung hat einen Code, einen Status (pass, warning oder error), eine Meldung und oft einen Pfad. Die folgenden Codes kann der Befehl ausgeben.

Der JSON-Bericht#

Mit --json besteht die Ausgabe aus einem einzigen JSON-Dokument und sonst nichts. Die Schlüssel der obersten Ebene sind schemaVersion, projectDir, status (ok, warning oder error), versions (installed, cli und published, immer null, weil doctor npm nie abfragt), inventory (status, trackedFiles), packs, integrations, processExecution, runtimes, checks (die volle Liste samt bestandener) und summary (passed, warnings, errors). Der Exit-Code folgt summary.errors.

Beispiele#

npx bmad-plus doctor --json > doctor.json || echo "installation needs attention"

npx bmad-plus doctor --verify-python