Function main_run_daemon_ctl

src/main.c:2444–2678

}

static int main_run_daemon_ctl(int argc, char **argv, const cbm_daemon_ipc_endpoint_t *endpoint,
                               const cbm_daemon_build_identity_t *identity,
                               const char *executable_path) {
    const char *subcommand = NULL;
    bool open_browser = false;
    int requested_port = 0;
    bool arguments_valid = true;
    for (int index = 1; index < argc; index++) {
        if (strcmp(argv[index], "daemon") == 0) {
            continue;
        }
        if (strcmp(argv[index], "start") == 0 || strcmp(argv[index], "stop") == 0 ||
            strcmp(argv[index], "status") == 0) {
            subcommand = argv[index];
        } else if (strcmp(argv[index], "--open") == 0) {
            open_browser = true;
        } else if (strncmp(argv[index], "--port=", 7) == 0) {
            requested_port = atoi(argv[index] + 7);
            if (requested_port <= 0 || requested_port >= MAIN_MAX_PORT) {
                (void)fprintf(stderr, "error: --port requires a value between 1 and 65535\n");
                return EXIT_FAILURE;
            }
        } else {
            (void)fprintf(stderr, "error: unknown daemon option: %s\n", argv[index]);
            arguments_valid = false;
            break;
        }
    }
    if (!arguments_valid || !subcommand) {
        (void)fprintf(stderr, "usage: codebase-memory-mcp daemon <start|stop|status> "
                              "[--open] [--port=N]\n");
        return EXIT_FAILURE;
    }

    cbm_daemon_runtime_status_t status;
    bool active = cbm_daemon_runtime_request_status(endpoint, identity,
                                                    MAIN_DAEMON_CTL_PROBE_TIMEOUT_MS, &status);

    if (strcmp(subcommand, "status") == 0) {
        if (!active) {
            if (status.muted_endpoint_holder_pid != 0) {
                /* Alive process, dead runtime (2026-08-29 zombie class).
                 * "not running" here sent the operator hunting through
                 * processes, pipes, and logs by hand; name the holder and the
                 * recovery instead. */
                printf("daemon: not responding (endpoint held by pid %llu)\n",
                       (unsigned long long)status.muted_endpoint_holder_pid);
                printf("hint: that process holds the daemon endpoint but answered nothing; "
                       "its runtime is likely dead. Terminate pid %llu, then run "
                       "`codebase-memory-mcp daemon start`.\n",
                       (unsigned long long)status.muted_endpoint_holder_pid);
                return EXIT_FAILURE;
            }
            printf("daemon: not running\n");
            printf("hint: `codebase-memory-mcp daemon start` keeps a daemon warm so CLI "
                   "commands and hooks skip the per-command startup cost.\n");
            return EXIT_FAILURE;
        }