Doctor

Check and repair setup / Einrichtung prüfen und reparieren

English · Deutsch

English

Run bastra doctor after installation or an update. bastra doctor --fix repairs registrations; it never enables intentionally disabled features.

The features section lists hooks, Stop hook and skill for registered clients, memory language (unset means English), onboarding, semantic recall and reflex memories. Each off item names its enable command. Optional code awareness, change-impact hints, product docs, Commons, bridges, the map and archiving appear as intentional opt-ins. This section does not change the exit code.

Doctor also reports narrowed MCP entries (BASTRA_TOOL_SURFACE=search removes write tools; BASTRA_MCP_SESSION_CONTEXT=0 disables tool-start context). Edit the named client entry when that restriction is unintended.

Missing save notices

Since 1.1.0 a missing save-notice matcher alone keeps otherwise healthy Claude Code or Codex recall hooks active. Re-run bastra install claude-code or bastra install codex; in Codex review/trust the write-tool hook in /hooks. Missing required recall hooks or malformed settings still need repair. Codex Save Notices explains rendering limits; BASTRA_SAVE_NOTICE=0 disables notices.

Daemon configuration and storage

The daemon origin section reports how the daemon started and warns if its config_fingerprint differs from configured behaviour settings. It compares daemon.env pins and, on macOS, managed LaunchAgent environment; paths, secrets and client-only settings are excluded. This warning does not change the exit code. Forwarder-spawned daemons drop client-only keys and apply the stored daemon settings. A registered macOS managed service gets up to ten seconds before a local fallback spawn; Linux managed setup remains outside this change.

Archive limits are shown when enabled (default cap 10 GB, no item limit). Doctor lists unimported client memory folders, enabled code repositories, bridge learning/demotion/archive status and derived source claims that differ, are gone or ambiguous; unverifiable claims are counted. Use Importing Memories, Code Awareness, Learned Bridges, Derived Claims and Archiving and Git Snapshots for the relevant controls.

If an existing cli-settings.json cannot be read, setting-writing commands stop rather than replacing it with defaults. Fix access before retrying. A previously recorded missing vault root is not recreated: mount its drive or select the intended vault. See Privacy and the usage guide.

Deutsch

Führe nach Einrichtung oder Update bastra doctor aus. bastra doctor --fix repariert Registrierungen; absichtlich ausgeschaltete Funktionen werden nie eingeschaltet.

Der Abschnitt features zeigt Hooks, Stop-Hook und Skill registrierter Clients, Memory-Sprache (ohne Einstellung Englisch), Onboarding, semantischen Recall und Reflex-Erinnerungen. Jeder ausgeschaltete Eintrag nennt seinen Einschaltbefehl. Optionale Code-Awareness, Change-Impact-Hinweise, Produkt-Doku, Commons, Bridges, Map und Archivierung erscheinen als bewusste Opt-ins. Dieser Abschnitt ändert den Exit-Code nicht.

Doctor meldet auch eingeschränkte MCP-Einträge (BASTRA_TOOL_SURFACE=search entfernt Schreibwerkzeuge; BASTRA_MCP_SESSION_CONTEXT=0 deaktiviert Kontext beim ersten Tool-Aufruf). Bearbeite den genannten Client-Eintrag, wenn die Einschränkung unbeabsichtigt ist.

Fehlende Speicherhinweise

Seit 1.1.0 lässt ein allein fehlender Speicherhinweis-Matcher ansonsten gesunde Recall-Hooks von Claude Code oder Codex aktiv. Führe bastra install claude-code oder bastra install codex erneut aus; prüfe und bestätige in Codex den Schreib-Tool-Hook in /hooks. Fehlende erforderliche Recall-Hooks oder beschädigte Einstellungen brauchen weiterhin Reparatur. Codex Save Notices erklärt Darstellungsgrenzen; BASTRA_SAVE_NOTICE=0 deaktiviert Hinweise.

Daemon-Konfiguration und Speicher

daemon origin meldet den Startweg und warnt, wenn der config_fingerprint von den konfigurierten Verhaltenseinstellungen abweicht. Verglichen werden daemon.env-Pins und unter macOS die Umgebung des verwalteten LaunchAgent; Pfade, Geheimnisse und reine Client-Einstellungen sind ausgenommen. Diese Warnung ändert den Exit-Code nicht. Vom Forwarder gestartete Daemons verwerfen reine Client-Schlüssel und verwenden gespeicherte Daemon-Einstellungen. Ein registrierter verwalteter macOS-Dienst bekommt bis zu zehn Sekunden vor einem lokalen Fallback-Start; verwaltete Linux-Einrichtung ist nicht Teil dieser Änderung.

Bei eingeschalteter Archivierung zeigt Doctor die Grenzen (Standardcap 10 GB, keine Einzelgrenze). Er nennt noch nicht importierte Client-Memory-Ordner, aktivierte Code-Repositories, Bridge-Lernen/Herabstufung/Archivierung und abweichende, verschwundene oder mehrdeutige abgeleitete Quell-Claims; nicht prüfbare Claims werden gezählt. Die Steuerung erklären Importing Memories, Code Awareness, Learned Bridges, Derived Claims und Archiving and Git Snapshots.

Ist eine vorhandene cli-settings.json nicht lesbar, brechen schreibende Einstellungsbefehle ab, statt sie durch Defaults zu ersetzen. Repariere den Zugriff vor dem nächsten Versuch. Ein zuvor vermerkter verschwundener Vault-Root wird nicht neu angelegt: Hänge sein Laufwerk ein oder wähle den vorgesehenen Vault. Siehe Privacy und Nutzungshandbuch.