Skip to content

Local code intelligence for developers and AI agents. Connect code, docs and infrastructure in a persistent graph, with CBM Lens, MCP tools, agent integrations and change-aware test selection.

3.3 KB
Raw Blame
/*
 * service.h — Stable daemon rendezvous and build-compatibility policy.
 *
 * The rendezvous key deliberately excludes executable path, release version,
 * build fingerprint, cache directory, and ABI values. Every stateful CBM
 * frontend for one OS account must meet at one endpoint; the HELLO comparison
 * then either admits the exact build or returns an explicit conflict.
 */
#ifndef CBM_DAEMON_SERVICE_H
#define CBM_DAEMON_SERVICE_H

#include "daemon/daemon.h"

#include <stdbool.h>
#include <stddef.h>
#include <stdint.h>

#define CBM_DAEMON_VERSION_TEXT_SIZE 64U
#define CBM_DAEMON_BUILD_FINGERPRINT_SIZE 65U
#define CBM_DAEMON_CONFLICT_MESSAGE_SIZE 512U

typedef struct {
    const char *semantic_version;
    const char *build_fingerprint;
    /* SHA-256 of the canonical cache-root path. It is intentionally excluded
     * from the stable HELLO envelope, but the account-wide lifetime cohort
     * compares it before any daemon/CLI work can begin. NULL means an internal
     * test/legacy identity with no cache namespace. */
    const char *cache_fingerprint;
    uint32_t protocol_abi;
    uint32_t store_abi;
    uint32_t feature_abi;
} cbm_daemon_build_identity_t;

typedef enum {
    CBM_DAEMON_HELLO_INVALID = 0,
    CBM_DAEMON_HELLO_COMPATIBLE,
    CBM_DAEMON_HELLO_VERSION_CONFLICT,
    CBM_DAEMON_HELLO_BUILD_CONFLICT,
    CBM_DAEMON_HELLO_PROTOCOL_ABI_CONFLICT,
    CBM_DAEMON_HELLO_STORE_ABI_CONFLICT,
    CBM_DAEMON_HELLO_FEATURE_ABI_CONFLICT,
    CBM_DAEMON_HELLO_CACHE_CONFLICT,
} cbm_daemon_hello_status_t;

typedef struct {
    cbm_daemon_hello_status_t status;
    char active_version[CBM_DAEMON_VERSION_TEXT_SIZE];
    char active_build_fingerprint[CBM_DAEMON_BUILD_FINGERPRINT_SIZE];
    char requested_version[CBM_DAEMON_VERSION_TEXT_SIZE];
    char requested_build_fingerprint[CBM_DAEMON_BUILD_FINGERPRINT_SIZE];
    char active_cache_fingerprint[CBM_DAEMON_BUILD_FINGERPRINT_SIZE];
    char requested_cache_fingerprint[CBM_DAEMON_BUILD_FINGERPRINT_SIZE];
} cbm_daemon_conflict_t;

/* Stable product key. OS-account isolation is supplied by the IPC runtime
 * directory / current-user ACL, never by caller-provided identity text. */
bool cbm_daemon_rendezvous_key(char out[CBM_DAEMON_KEY_SIZE]);

/* SHA-256 of the exact executable bytes, encoded as 64 lowercase hex
 * characters plus NUL. This is captured once at process startup. */
bool cbm_daemon_build_fingerprint_file(const char *path,
                                       char out[CBM_DAEMON_BUILD_FINGERPRINT_SIZE]);

cbm_daemon_hello_status_t cbm_daemon_hello_compare(const cbm_daemon_build_identity_t *active,
                                                   const cbm_daemon_build_identity_t *requested,
                                                   cbm_daemon_conflict_t *conflict_out);

bool cbm_daemon_conflict_format(const cbm_daemon_conflict_t *conflict, char *out, size_t out_size);

/* Append one secret-free NDJSON conflict event. A persistent owner-only
 * <log_path>.lock serializes validation, rotation, and append across daemon
 * processes; cap_bytes rotates one complete prior generation to <log_path>.1
 * before appending a record that would cross the cap. */
bool cbm_daemon_conflict_log_append(const char *log_path, const cbm_daemon_conflict_t *conflict,
                                    size_t cap_bytes);

#endif /* CBM_DAEMON_SERVICE_H */