causet doctor

causet doctor is a real, shipped command, but it is a lightweight local diagnostic, not the full infrastructure health check described in earlier drafts of this page (no Kafka, Redis, S3, projection-table, or fixture-replay checks — those are not implemented today).

Usage

causet doctor

The command takes no required flags. Pass the global --json flag for machine-readable output.

Checks

CheckWhat it validates
CLI versionInstalled causet version
Compiler binaryThe native compiler binary resolves on your machine
Auth tokenWhether you’re logged in (causet login) and, if so, which account
Platform / application / fork contextYour effective CLI context (causet context show)
.causet/causet.yamlWhether a project config file is present in the current directory tree
Runtime reachableBest-effort HTTP reachability of the runtime API (CAUSET_API_URL, default localhost:8085)
Query service reachableBest-effort HTTP reachability of the query service (CAUSET_QUERY_URL, default localhost:8086)
Cloud reachableBest-effort HTTP reachability of the Causet Cloud API (if logged in)

Example output

  Causet Doctor
  ────────────────────────────────────
  ✓  cli version                v1.4.2
  ✓  compiler binary            /usr/local/bin/causet-compiler
  ✓  auth token                 you@example.com
  ✓  platform context           my-platform
  ✓  application context        concert-app
  ✓  fork context                main
  ✓  .causet/causet.yaml         my-platform
  ✓  environment                 production
  ✓  runtime reachable           http://localhost:8085
  ✓  query service reachable     http://localhost:8086
  ✓  cloud reachable             https://api.causet.io

Any ✗ marks a failed check; the command prints “Some checks failed” but does not fail CI by itself. Use causet build validate for a DSL-specific pre-deploy gate — see Projection Best Practices.

Related commands

  • causet version — print the full version block; also explains the version compatibility check that runs before every compilation
  • causet build compile — compile DSL before deploying
  • causet forensics — sandbox drift check and per-decision repair (verify context with doctor first)
  • causet context show — inspect the context doctor reports on (see Install Causet and Quickstart: Concert App)
  • causet projections doctor and the other projection-management subcommands described elsewhere in this section are proposed and have no CLI equivalent today.
What is Causet?