Skip to content

driver.query and driver.health (M1): the application query and driver health - #53

Merged
jcombs-pointblue merged 1 commit into
masterfrom
claude/query-health
Oct 9, 2026
Merged

jcombs-pointblue merged 1 commit into
masterfrom
claude/query-health

Conversation

@jcombs-pointblue

Copy link
Copy Markdown
Contributor

Phase M1 of docs/console-gaps.md (gaps G9 and G7), §10 of the note.

driver.query — the console's queryValues: the engine's query verb goes as a command into the running driver's subscriber channel (the same door as driver.submit) and the shim's <instance>s come back, as text or JSON. Options: --class, --scope subtree|subordinates|entry, --dn (an LDAP DN is converted to the slash form the verb takes, found the hard way on the first live try), --association, --search name=value…, --read-attr A… or none for a match test. A stopped driver is refused up front. Gated light and audited. Proven on edir3 through the Loopback driver: a search by CN returned the user with Surname and Given Name; an entry-scope query with --read-attr none returned the bare instance.

driver.health [clear] — grounded on the Driver Health job's own code (ckdrvhealthjob.jar): the job evaluates each driver's <health-config> from its DirXML-ConfigManifest and writes the verdict per server to the driver's DirXML-uiXMLSmall. The command prints the last state per server (and each custom state), the configured states with condition-group and action counts, and the set's health jobs with whether the driver is in scope. clear removes the recorded status, which is what the console's clearDriverHealthStatus amounts to. No lab driver carries a health configuration, so the parsing is tested against the job's document shapes and live only for the empty case.

Also: job.* and rbe.* were missing from the main usage text; added.

Tests: four new cases in OperateTest (query build and parse, running-driver refusal and read-none, health read, health clear). Full suite and bin/ci-portable.sh green. edir3 unchanged (the Loopback driver was started for the query and stopped again).

Left for later: the health configuration in the tree (the manifest is not modelled), the web's "ask the application" on the Objects tab.

🤖 Generated with Claude Code

…th (M1)

driver.query sends the engine's query verb as a command into the running
driver's subscriber channel and prints the shim's instances; an LDAP DN is
converted to the slash form the verb takes. Proven on edir3 through the
Loopback driver. driver.health reads what the Driver Health job records on
the driver (DirXML-uiXMLSmall), the health configuration on its manifest and
the set's health jobs; clear removes the recorded status. Grounded on the
job's own code (docs/console-gaps.md §10).

The main usage now lists job.* and rbe.* too.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@jcombs-pointblue
jcombs-pointblue merged commit e0933bf into master Oct 9, 2026
4 checks passed
@jcombs-pointblue

Copy link
Copy Markdown
Contributor Author

Merged into master and released as 0.23.0.

@jcombs-pointblue
jcombs-pointblue deleted the claude/query-health branch October 9, 2026 23:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant