enumeray connector reconcile

Retrieve existing assignment evidence and reconcile process ownership without new claims.

Use when: An interrupted one-shot session needs recovery of already assigned work.

Role and prerequisites: Connector host operator. Install enumeray on the execution control host. Retain its private journal on durable storage; keep one process owner and the matching connector credential. See recovery rules before taking over retained state.

Example

enumeray connector reconcile --journal ./local-journal --token-file ./connector-state/token --confirm-prior-process-stopped

The example’s confirmation flag is valid only after verifying the previous owner stopped on every host. A stopped connector process is not proof that its backend job stopped; use recovery guidance.

Inputs and options

Input	Meaning and use
--journal <JOURNAL>	Private durable journal directory. Reuse the same path after restart and never copy it to create another active connector. It contains ownership and backend execution evidence.
--token-file <TOKEN_FILE>	Private regular file containing only the connector bearer token, typically the token file written by enroll. One-shot commands read a token from stdin if omitted.
--confirm-prior-process-stopped	Explicit recovery assertion that the journal’s previous process stopped on every host, including out-of-band processes. Establish this externally before using the flag; it is not a backend cancellation command.

Host commands use explicit connector credentials or the private journal and emit JSON results; compute-runner uses only its stdin protocol and directory. User profile and API override options do not apply.

Result and next step

Reconciles retained/server ownership and existing work. It does not claim a new assignment or launch backend execution.

Inspect retained evidence before execute-once; preserve the journal if ownership or backend outcome remains unresolved.

Exact syntax, defaults and accepted values

Retrieve existing work and reconcile ownership without claiming or launching work

Usage: enumeray connector reconcile [OPTIONS] --journal <JOURNAL>

Options:
      --api <API>                      User API origin override; credentials never cross origins. Host/runner commands use explicit configuration
      --journal <JOURNAL>              Existing private durable journal directory containing the original execution evidence
      --profile <PROFILE>              Named local user API/login profile; host/runner commands use explicit configuration [default: default]
      --token-file <TOKEN_FILE>        Private regular file containing the connector bearer token; omit to read token text from stdin
      --config <CONFIG>                Private user profiles file; defaults to $XDG_CONFIG_HOME/enumeray/profiles.json or ~/.config/enumeray/profiles.json
      --confirm-prior-process-stopped  Assert that the previous process has stopped, including on other hosts
      --json                           Emit user API results as JSON (NDJSON for following logs) and runtime errors on stderr; host/runner output follows its own protocol
      --timeout <TIMEOUT>              User API HTTP timeout in seconds; live logs use it for read inactivity. Does not limit execution time [default: 60]
  -h, --help                           Print help