singularity ecosystem opportunities

singularity ecosystem opportunities --state-dir STATE [--limit N] [--before CURSOR] --json

The result contains items and next_cursor, newest insert first. Without --limit every opportunity is listed. With it, a non-null next_cursor passed as --before reads older entries. A limit of zero or a cursor that is not positive is refused: records takes a limit of at least 1 when given and a positive before cursor.

Listing neither accepts an opportunity nor allocates an initiative.

Shared control options

--state-dir PATH names the live owner's state directory; its environment equivalent is SINGULARITY_STATE_DIR. It is required: no directory is assumed. --json prints the whole response envelope; without it a successful answer prints only its result, and a refusal prints the whole envelope.

The owner and the client must run as the same Unix user. An owner that is not listening is a refusal — ecosystem owner unavailable at <socket>: <error>; no cached state is presented as live — and every refusal exits nonzero.