Skip to content

Latest commit

 

History

History

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 
 
 
 
 
 
 

Example Doctor Plugin

This package is the smallest business-neutral example of a Doctor Plugin. It declares two example services and a few capabilities. Loading the Plugin does not connect to a real system. The Service declarations also show how a Plugin contributes Toolchain metadata while Doctor Core retains ownership of runtime collection.

Use it as a starting point for a separately distributed Plugin. Business service names, topology, queries and access implementations belong in that Plugin rather than in the Doctor CLI.

The API Service contributes a shared connectivity Case through Service.cases; doctor case lists it offline. The Worker's health.case.bindings references that source. Running doctor health --service example-worker requires a matching deployment and checks the API from the Worker container; it does not use the Doctor Host's network path.

The workspace version identifies both Plugin code and bundled Skills. Run make bump-plugin-version PLUGIN=example whenever either content set changes.

Run make build in this directory to create the self-contained dist/example-<version>.doctor-plugin.tar.gz archive. The target Doctor host does not need the Plugin source tree or an additional package installation step.

The Plugin also registers an offline error.catalog. After installing its archive, query the example definition without configuring a target:

doctor knowledge errors QUEUE_BUSY
doctor knowledge errors --extension-namespace plugin/example --format json

The catalog source version describes the error definitions; it is independent of the Plugin version.