WHCandCursor
812e3ee265
Seats publish via parliament_note, sync pushes on write, member join without stealing the chair, and worker tools are hard-gated when parliament is active. Co-authored-by: Cursor <cursoragent@cursor.com>
104 lines
4.3 KiB
C
104 lines
4.3 KiB
C
#ifndef CST_PARLIAMENT_H
|
|
#define CST_PARLIAMENT_H
|
|
|
|
#include "cst_realm.h"
|
|
|
|
#include <stddef.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/* Parliament is one shared whole across agents. Password unlock claims the
|
|
* single chair on the logging-in device; peers sync the same context. A new
|
|
* project replaces all parliament context. */
|
|
|
|
typedef struct {
|
|
char parliament_id[64];
|
|
char project_id[64];
|
|
char chair_instance[64];
|
|
char chair_device[128];
|
|
unsigned long revision;
|
|
char status[32]; /* idle | open | dissolved */
|
|
} cst_parliament_meta_t;
|
|
|
|
int cst_parliament_path(char *out, size_t n);
|
|
int cst_parliament_load(cst_parliament_meta_t *m);
|
|
int cst_parliament_save(const cst_parliament_meta_t *m);
|
|
|
|
/* Login: unlock Realm with password, enroll/ensure instance, claim chair,
|
|
* return handover summary (malloc'd) or NULL. */
|
|
char *cst_parliament_login(const char *password, const char *instance_id,
|
|
const char *device_label, char *err, size_t err_sz);
|
|
|
|
/* Join as a peer seat without stealing the chair (claims only if vacant).
|
|
* Returns JOIN_OK summary (malloc'd) or NULL. */
|
|
char *cst_parliament_seat_join(const char *password, const char *instance_id,
|
|
const char *device_label, char *err,
|
|
size_t err_sz);
|
|
|
|
/* Only one chair: previous chair is demoted; handover notes left in meta. */
|
|
int cst_parliament_claim_chair(const char *instance_id, const char *device_label);
|
|
|
|
/* Probe local environment as device-private context (malloc'd text). */
|
|
char *cst_parliament_device_context(void);
|
|
|
|
/* Prefer CST_INSTANCE_ID, else sanitized hostname (never empty). */
|
|
int cst_parliament_default_instance(char *out, size_t n);
|
|
|
|
/* New project: wipe shared parliament context; keep Realm keys. */
|
|
int cst_parliament_new_project(const char *project_id);
|
|
|
|
/* Resolve collaboration mode: env CST_COLLABORATION, then settings,
|
|
* then password-Realm with an open parliament → "parliament". */
|
|
int cst_parliament_is_active(void);
|
|
/* 1 when the local seat ticket matches the current chair. */
|
|
int cst_parliament_is_chair(void);
|
|
/* Short status lines for TUI/CLI (malloc'd; caller frees). */
|
|
char *cst_parliament_status_text(void);
|
|
|
|
/* Append/replace synchronized context blob (all agents share this file). */
|
|
int cst_parliament_context_put(const char *text);
|
|
char *cst_parliament_context_get(void);
|
|
/* Append a structured seat note and bump revision (triggers peer sync).
|
|
* kind: status | agenda | result | handover | note */
|
|
int cst_parliament_context_append(const char *seat_id, const char *kind,
|
|
const char *body);
|
|
|
|
/* Ask the local parliament service to dial peers soon (best-effort). */
|
|
void cst_parliament_sync_request(void);
|
|
int cst_parliament_sync_pending(void);
|
|
void cst_parliament_sync_ack(void);
|
|
|
|
/* Local login ticket: opens require a fresh seat session (or password env).
|
|
* Any enrolled seat may hold a ticket; chair is tracked separately in meta. */
|
|
int cst_parliament_session_write(const char *instance_id);
|
|
int cst_parliament_session_ok(char *instance_id_out, size_t n);
|
|
void cst_parliament_session_clear(void);
|
|
|
|
/* Apply a peer sync bundle (higher revision already selected by caller). */
|
|
int cst_parliament_apply_sync(unsigned long revision, const char *parliament_id,
|
|
const char *project_id, const char *chair,
|
|
const char *context);
|
|
|
|
/* Background parliament service: discover + peer listen + context sync. */
|
|
int cst_parliament_daemon_pidfile(char *out, size_t n);
|
|
int cst_parliament_daemon_running(void);
|
|
/* Read pidfile metadata. Returns 0 when a live service is recorded. */
|
|
int cst_parliament_daemon_info(int *pid_out, char *instance_out, size_t in_sz,
|
|
int *port_out);
|
|
/* Start in background (Unix fork). password unlocks Realm in the child.
|
|
* Returns 0 and writes pid. Restarts if a different instance/port is running. */
|
|
int cst_parliament_daemon_start(const char *password, const char *instance_id,
|
|
int peer_port, char *err, size_t err_sz);
|
|
int cst_parliament_daemon_stop(void);
|
|
/* Foreground service loop (used by --service and the forked child). */
|
|
int cst_parliament_daemon_run(const char *password, const char *instance_id,
|
|
int peer_port, char *err, size_t err_sz);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif
|