Module doctor 

doctor-json: the eighteen checks behind the opencode-ctl-doctor skill (spec Skills).

The doctor COMPUTES the checks in a fixed order (ctl_home_override, binary, registration, server_info, then the rest in id order) and EMITS them in id order. registration is read before anything can start the service, so an ok_started cannot rewrite the file it reports on. server_info is the ONE place that starts a stopped service, explicitly; every other check leaves the service alone: wait_route never fetches the OpenAPI document itself (it reads the table server.info already cached) and registration never calls server.info.

Every pair decision keys on the FILE NAME’s id (pair.<id>.json), never on the id inside the record: records_by_name enumerates the files itself and overwrites the record’s inner id.

Structs

Check

DoctorCtx

ServerState 🔒

SourceFile

The two lines of opencode-pair.exe.source: path=<staged path> and version=<plugin semver> (spec install-launcher; split on the first =, any parse failure counts as absent).

Enums

LinkStatus

Status

Constants

BINARY_NAMES 🔒

CHECK_IDS

The check ids, in emit order.

MESSAGES 🔒

Every message the doctor can print, keyed by (id, status, variant); <...> placeholders are filled by message. A check with several texts per status has one variant tag per text.

PROTECTED 🔒

The protected keys (spec Settings), in the order the doctor lists them.

SIDES 🔒

Functions

binary_check 🔒

ctl_home_override 🔒

default_config_file

The service config’s default location: $OPENCODE_CONFIG_DIR/service.json (packages/util/src/global.ts:79), else $XDG_CONFIG_HOME/opencode/, else ~/.config/opencode/.

default_registration_file

The registration file’s default location: $XDG_STATE_HOME/opencode/service.json, else ~/.local/state/opencode/service.json (packages/util/src/global.ts:79 roots).

doctor_json

The doctor report: {"checks":[...], "notes":[...], "settings"?}.

env_vs_user_file 🔒

first_line 🔒

hex 🔒

launcher_link_check 🔒

launcher_link_status

POSIX: the opencode-pair symlink’s target; Windows: the copy and its .source file.

link_name 🔒

lock_source_check 🔒

log_check 🔒

message 🔒

mtime_ms 🔒

name_status 🔒

Which kind of binary a staged or linked file name belongs to, relative to host.

note_json 🔒

opencode_password_set 🔒

orphaned_controllers 🔒

orphaned_workers 🔒

pairing_check 🔒

parse_source_file

reason_words 🔒

registration_check 🔒

resolved_settings 🔒

same_path 🔒

server_info_check 🔒

server_url_password 🔒

settings_file_hash 🔒

settings_notes 🔒

side_words 🔒

source_name 🔒

stem_of 🔒

A file name with the .exe suffix dropped, from either kind of separator.

version_range_check 🔒

wait_route_check 🔒

windows_link_status

The Windows rule on already-read inputs (pure, so it is tested on every platform): Stale when the .source path= differs from the running exe OR its version= differs from version.

windows_source_old_check

windows_source_old on a given platform flag (so the Windows rule is tested everywhere): the copy’s .source file must parse, and no .old leftover may remain.