#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);

/* 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);

/* 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);
/* 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);

/* Local login ticket: opens require a fresh chair session (or password env). */
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);
/* Start in background (Unix fork). password unlocks Realm in the child.
 * Returns 0 and writes pid. If already running, returns 0. */
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