quorum_participant_set

Category: quorum
Access: write
Audience: administrative (ordinary users do not normally call this directly)

Purpose

Marks one quorum participant's standing. Call it when a required client or role joins, fulfils, or withdraws from the agreed-what so quorum visibility and later resolution reflect reality.

Arguments

Required: quorum_id, kind, ref, state.

quorum_id.
kind. Note: client or role. Client refs must name a live principal.
ref.
state. Note: pending, joined, fulfilled, or withdrawn. pending is the birth standing; the other three are forward marks set here.

Result

JSON object with quorum_id, kind, ref, and state (the new participant standing).

Boundaries

Requires the conductor role in the current implementation. Applies only to open quorums inside the caller's profile boundary. Role refs are names; live debate binding is checked at read time, not at this call.

Lifecycle / side effects

Adds the participant or moves its standing (creation-or-change semantics) and records an audit/history event. Only open quorums accept marks.

Errors

Missing conductor role is denied. Missing or malformed identity reads as unknown_quorum. Non-open quorums are rejected as quorum not open. Bad kind or ref is rejected as invalid participant; bad standing as invalid state; dangling client refs as unknown client.

Example

{
  "kind": "client",
  "quorum_id": "<uuid>",
  "ref": "worker-1",
  "state": "joined"
}

Result shape:

{
  "kind": "client",
  "quorum_id": "<uuid>",
  "ref": "worker-1",
  "state": "joined"
}