chore: Run pnpm format:fix.

docs/refactor/strict-config.md

@@ -5,19 +5,23 @@ read_when:
   - Working on config migrations or doctor workflows
   - Handling plugin config schemas or plugin load gating
 ---
+
 # Strict config validation (doctor-only migrations)
 
 ## Goals
+
 - **Reject unknown config keys everywhere** (root + nested).
 - **Reject plugin config without a schema**; don’t load that plugin.
 - **Remove legacy auto-migration on load**; migrations run via doctor only.
 - **Auto-run doctor (dry-run) on startup**; if invalid, block non-diagnostic commands.
 
 ## Non-goals
+
 - Backward compatibility on load (legacy keys do not auto-migrate).
 - Silent drops of unrecognized keys.
 
 ## Strict validation rules
+
 - Config must match the schema exactly at every level.
 - Unknown keys are validation errors (no passthrough at root or nested).
 - `plugins.entries.<id>.config` must be validated by the plugin’s schema.
@@ -26,11 +30,12 @@ read_when:
 - Plugin manifests (`openclaw.plugin.json`) are required for all plugins.
 
 ## Plugin schema enforcement
+
 - Each plugin provides a strict JSON Schema for its config (inline in the manifest).
 - Plugin load flow:
-  1) Resolve plugin manifest + schema (`openclaw.plugin.json`).
-  2) Validate config against the schema.
-  3) If missing schema or invalid config: block plugin load, record error.
+  1. Resolve plugin manifest + schema (`openclaw.plugin.json`).
+  2. Validate config against the schema.
+  3. If missing schema or invalid config: block plugin load, record error.
 - Error message includes:
   - Plugin id
   - Reason (missing schema / invalid config)
@@ -38,6 +43,7 @@ read_when:
 - Disabled plugins keep their config, but Doctor + logs surface a warning.
 
 ## Doctor flow
+
 - Doctor runs **every time** config is loaded (dry-run by default).
 - If config invalid:
   - Print a summary + actionable errors.
@@ -48,7 +54,9 @@ read_when:
   - Writes updated config.
 
 ## Command gating (when config is invalid)
+
 Allowed (diagnostic-only):
+
 - `openclaw doctor`
 - `openclaw logs`
 - `openclaw health`
@@ -59,6 +67,7 @@ Allowed (diagnostic-only):
 Everything else must hard-fail with: “Config invalid. Run `openclaw doctor --fix`.”
 
 ## Error UX format
+
 - Single summary header.
 - Grouped sections:
   - Unknown keys (full paths)
@@ -66,6 +75,7 @@ Everything else must hard-fail with: “Config invalid. Run `openclaw doctor --f
   - Plugin load failures (plugin id + reason + path)
 
 ## Implementation touchpoints
+
 - `src/config/zod-schema.ts`: remove root passthrough; strict objects everywhere.
 - `src/config/zod-schema.providers.ts`: ensure strict channel schemas.
 - `src/config/validation.ts`: fail on unknown keys; do not apply legacy migrations.
@@ -75,6 +85,7 @@ Everything else must hard-fail with: “Config invalid. Run `openclaw doctor --f
 - CLI command gating in `src/cli`.
 
 ## Tests
+
 - Unknown key rejection (root + nested).
 - Plugin missing schema → plugin load blocked with clear error.
 - Invalid config → gateway startup blocked except diagnostic commands.