weavori doctor

Run comprehensive diagnostics on your Weavori setup.

Last updated October 20, 2018

Usage

$weavori doctor [dsn] [flags]

The doctor command runs a series of diagnostics to identify configuration, connectivity, and compatibility issues, with actionable recommendations when problems are found.

Flags

FlagDefaultDescription
--verbosefalseInclude timings and troubleshooting advice
--quietfalseOnly show warnings, failures, and summary
--no-colorfalseDisable ANSI color output
--strictfalseTreat warnings as failures (exit code 1)
--fixfalseAuto-repair safe, local-only issues

Example

$ weavori doctor "postgres://user:pass@localhost:5432/mydb"
Configuration ──
Config file exists and is readable
Server URL is reachable
Network ──
API server is reachable (48ms)
DNS resolution successful
PostgreSQL ──
Connection successful (12ms)
PostgreSQL 16.4
SSL enabled
Required permissions OK
Extensions: pg_stat_statements (expected)
Summary: 11 passed, 0 warnings, 0 failures

JSON

Use --output json for machine-readable output:

$weavori doctor "postgres://user:pass@localhost:5432/mydb" --output json

Output

{
  "version": "1.0",
  "duration_ms": 2340,
  "categories": {
    "configuration": { "passed": 2, "warnings": 0, "failures": 0, "skipped": 0 },
    "postgres": { "passed": 5, "warnings": 0, "failures": 0, "skipped": 0 }
  },
  "checks": [
    {
      "name": "Config file",
      "status": "pass",
      "category": "configuration",
      "duration_ms": 2,
      "message": "...",
      "suggestion": ""
    }
  ],
  "summary": { "passed": 11, "warnings": 0, "failures": 0, "skipped": 0, "exit_code": 0 }
}