mode_defaults.h File Reference

Mode-aware default value getters and mode metadata. More...

Go to the source code of this file.

Data Structures
struct	mode_descriptor_t
	Metadata for a mode. More...

Functions
const void *	get_default_log_file (asciichat_mode_t mode)
	Get mode-specific default value for –log-file.
const void *	get_default_port (asciichat_mode_t mode)
	Get mode-specific default value for –port.
const void *	get_default_websocket_port (asciichat_mode_t mode)
	Get mode-specific default value for –websocket-port.
void	apply_mode_specific_defaults (options_t *opts)
	Apply mode-specific defaults to an options struct after mode detection.
const mode_descriptor_t *	get_mode_descriptor (asciichat_mode_t mode)
	Get mode descriptor by mode.
const mode_descriptor_t *	get_modes_by_group (const char *group, size_t *out_count)
	Get all mode descriptors for a specific group.

Detailed Description

Mode-aware default value getters and mode metadata.

Provides mode-specific default values and metadata (names, descriptions, groups) for all application modes. Used by option parsing and completion generation.

Author

Zachary Fogg me@zf.nosp@m.o.gg

Date

February 2026

Definition in file mode_defaults.h.

Function Documentation

apply_mode_specific_defaults()

void apply_mode_specific_defaults

(

options_t *

opts

)

Apply mode-specific defaults to an options struct after mode detection.

Updates options that have mode-dependent defaults (like log_file, port, and websocket_port) based on the detected mode. Should be called after mode detection but before option parsing.

Parameters

opts	Options struct to update (must have detected_mode already set)

This function updates options that have mode-dependent defaults (port and websocket_port) based on the detected mode. Log file paths are handled separately by options_get_log_filepath().

Parameters

opts	Options struct to update (must have detected_mode already set)

Definition at line 194 of file mode_defaults.c.

                                                   {
  if (!opts) {
    return;
  }
 
  // Apply port default based on mode
  const int *mode_port = (const int *)get_default_port(opts->detected_mode);
  if (mode_port && opts->detected_mode != MODE_MCP_SERVER && opts->detected_mode != MODE_API_SERVER) {
    // Only update if still at a generic default (27224 or 27225)
    if (opts->port == OPT_PORT_INT_DEFAULT || opts->port == OPT_ACDS_PORT_INT_DEFAULT) {
      opts->port = *mode_port;
    }
  }
 
  // Apply websocket-port default based on mode
  const int *mode_websocket_port = (const int *)get_default_websocket_port(opts->detected_mode);
  if (mode_websocket_port) {
    // Only update if still at a generic default (27226 or 27227)
    if (opts->websocket_port == OPT_WEBSOCKET_PORT_SERVER_DEFAULT ||
        opts->websocket_port == OPT_WEBSOCKET_PORT_ACDS_DEFAULT) {
      opts->websocket_port = *mode_websocket_port;
    }
  }
 
  // If TLS cert+key are provided and websocket-port was not explicitly set,
  // default to 443 (standard HTTPS/WSS port) instead of the mode default.
  if (opts->tls_cert[0] != '\0' && opts->tls_key[0] != '\0') {
    if (opts->websocket_port == OPT_WEBSOCKET_PORT_SERVER_DEFAULT ||
        opts->websocket_port == OPT_WEBSOCKET_PORT_ACDS_DEFAULT) {
      opts->websocket_port = 443;
    }
  }
}

References options_state::detected_mode, get_default_port(), get_default_websocket_port(), MODE_API_SERVER, MODE_MCP_SERVER, OPT_ACDS_PORT_INT_DEFAULT, OPT_PORT_INT_DEFAULT, OPT_WEBSOCKET_PORT_ACDS_DEFAULT, OPT_WEBSOCKET_PORT_SERVER_DEFAULT, options_state::port, options_state::tls_cert, options_state::tls_key, and options_state::websocket_port.

get_default_log_file()

const void * get_default_log_file

(

asciichat_mode_t

mode

)

Get mode-specific default value for –log-file.

Parameters

mode	The mode to get the default for

Returns

Pointer to the default log file path for this mode

Returns empty string - the actual log file path is determined by options_get_log_filepath() which properly handles debug vs release builds and platform-specific temp directories.

Debug builds: Uses current working directory (server.log, client.log, etc.) Release builds: Uses $TMPDIR/ascii-chat/server.log, etc.

Definition at line 111 of file mode_defaults.c.

                                                        {
  (void)mode; // Unused
  // Return empty string - let options_get_log_filepath() handle the defaults
  return "";
}

get_default_port()

const void * get_default_port

(

asciichat_mode_t

mode

)

Get mode-specific default value for –port.

Parameters

mode	The mode to get the default for

Returns

Pointer to the default port number for this mode

Definition at line 129 of file mode_defaults.c.

                                                    {
  switch (mode) {
  case MODE_MCP_SERVER: {
    static const int port = OPT_MCP_PORT_DEFAULT;
    return &port;
  }
  case MODE_API_SERVER: {
    static const int port = OPT_MCP_PORT_DEFAULT;
    return &port;
  }
  case MODE_SERVER:
    return &g_port_server;
  case MODE_CLIENT:
    return &g_port_client;
  case MODE_DISCOVERY_SERVICE:
    return &g_port_discovery_service;
  case MODE_DISCOVERY:
    return &g_port_discovery;
  case MODE_MIRROR:
  case MODE_INVALID:
  default:
    // Fallback
    return &g_port_server;
  }
}

References MODE_API_SERVER, MODE_CLIENT, MODE_DISCOVERY, MODE_DISCOVERY_SERVICE, MODE_INVALID, MODE_MCP_SERVER, MODE_MIRROR, MODE_SERVER, and OPT_MCP_PORT_DEFAULT.

Referenced by apply_mode_specific_defaults().

get_default_websocket_port()

const void * get_default_websocket_port

(

asciichat_mode_t

mode

)

Get mode-specific default value for –websocket-port.

Parameters

mode	The mode to get the default for

Returns

Pointer to the default WebSocket port number for this mode

Definition at line 165 of file mode_defaults.c.

                                                              {
  switch (mode) {
  case MODE_SERVER:
    return &g_websocket_port_server;
  case MODE_DISCOVERY_SERVICE:
    return &g_websocket_port_discovery_service;
  case MODE_CLIENT:
  case MODE_MIRROR:
  case MODE_DISCOVERY:
  case MODE_INVALID:
  default:
    // Fallback (should not be used for client/mirror/discovery)
    return &g_websocket_port_server;
  }
}

References MODE_CLIENT, MODE_DISCOVERY, MODE_DISCOVERY_SERVICE, MODE_INVALID, MODE_MIRROR, and MODE_SERVER.

Referenced by apply_mode_specific_defaults().

get_mode_descriptor()

const mode_descriptor_t * get_mode_descriptor

(

asciichat_mode_t

mode

)

Get mode descriptor by mode.

Returns metadata (name, description, group) for the given mode. Useful for UI generation and help text.

Parameters

mode	Mode to look up

Returns

Pointer to mode descriptor, or NULL if mode not found

Example

const mode_descriptor_t *desc = get_mode_descriptor(MODE_SERVER);
if (desc) {
    printf("Mode: %s\nDescription: %s\nGroup: %s\n",
           desc->name, desc->description, desc->group);
}

Parameters

mode	Mode to look up

Returns

Pointer to mode descriptor, or NULL if not found

Definition at line 43 of file mode_defaults.c.

                                                                    {
  for (size_t i = 0; g_mode_descriptors[i].name; i++) {
    if (g_mode_descriptors[i].mode == mode) {
      return &g_mode_descriptors[i];
    }
  }
  return NULL;
}

get_modes_by_group()

const mode_descriptor_t * get_modes_by_group	(	const char *	group,
		size_t *	out_count )

Get all mode descriptors for a specific group.

Returns all modes in a given category (e.g., "server-like" or "client-like"). The returned array is allocated with SAFE_MALLOC and must be freed by caller.

Parameters

group	Group name ("server-like" or "client-like")
out_count	OUTPUT: Number of modes in this group

Returns

Array of mode descriptors (caller must free with SAFE_FREE), or NULL if group not found

Example

size_t count;
const mode_descriptor_t *server_modes = get_modes_by_group("server-like", &count);
if (server_modes) {
    for (size_t i = 0; i < count; i++) {
        printf("%s: %s\n", server_modes[i].name, server_modes[i].description);
    }
    SAFE_FREE(server_modes);
}

Get all mode descriptors for a specific group.

Parameters

group	Group name ("server-like" or "client-like")
out_count	OUTPUT: Number of modes in this group

Returns

Array of mode descriptors, or NULL if group not found

Definition at line 58 of file mode_defaults.c.

                                                                                  {
  if (!group || !out_count) {
    return NULL;
  }
 
  // Count matching modes
  size_t count = 0;
  for (size_t i = 0; g_mode_descriptors[i].name; i++) {
    if (strcmp(g_mode_descriptors[i].group, group) == 0) {
      count++;
    }
  }
 
  if (count == 0) {
    *out_count = 0;
    return NULL;
  }
 
  // Allocate result array
  mode_descriptor_t *result = SAFE_MALLOC((count + 1) * sizeof(mode_descriptor_t), mode_descriptor_t *);
  size_t idx = 0;
 
  // Fill result array
  for (size_t i = 0; g_mode_descriptors[i].name && idx < count; i++) {
    if (strcmp(g_mode_descriptors[i].group, group) == 0) {
      result[idx++] = g_mode_descriptors[i];
    }
  }
 
  // Add terminator
  result[idx].mode = MODE_INVALID;
  result[idx].name = NULL;
  result[idx].description = NULL;
  result[idx].group = NULL;
 
  *out_count = count;
  return result;
}

References mode_descriptor_t::description, mode_descriptor_t::group, mode_descriptor_t::mode, MODE_INVALID, mode_descriptor_t::name, and SAFE_MALLOC.

Referenced by completions_generate_zsh().