Function handle_list_projects

src/mcp/mcp.c:2854–3079

list_projects: scan cache directory for .db files. * Each project is a single .db file — no central registry needed. */

/* list_projects: scan cache directory for .db files.
 * Each project is a single .db file — no central registry needed. */
static char *handle_list_projects(cbm_mcp_server_t *srv, const char *args) {
    (void)srv;
    bool metadata_only = false;
    yyjson_doc *args_doc = args ? yyjson_read(args, strlen(args), 0) : NULL;
    yyjson_val *args_root = args_doc ? yyjson_doc_get_root(args_doc) : NULL;
    yyjson_val *metadata_value =
        args_root && yyjson_is_obj(args_root) ? yyjson_obj_get(args_root, "metadata_only") : NULL;
    metadata_only = metadata_value && yyjson_is_true(metadata_value);
    char *detail = cbm_mcp_get_string_arg(args, "detail");
    /* `include_details` is the boolean spelling main shipped for the same
     * request; both select the stats projection. */
    bool include_stats = !metadata_only && ((detail && strcmp(detail, "stats") == 0) ||
                                            cbm_mcp_get_bool_arg(args, "include_details"));
    free(detail);
    if (args_doc) {
        yyjson_doc_free(args_doc);
    }

    char dir_path[CBM_SZ_1K];
    cache_dir(dir_path, sizeof(dir_path));

    cbm_dir_t *d = cbm_opendir(dir_path);

    if (!d) {
        char msg[CBM_SZ_1K];
        snprintf(msg, sizeof(msg),
                 "{\"error\":\"cannot read cache directory: %s\",\"hint\":"
                 "\"Check directory permissions or run index_repository first.\"}",
                 dir_path);
        return cbm_mcp_text_result(msg, true);
    }

    mcp_project_record_t *records = NULL;
    int record_count = 0;
    int record_cap = 0;
    bool oom = false;
    cbm_dirent_t *entry;
    while ((entry = cbm_readdir(d)) != NULL) {
        const char *name = entry->name;
        size_t len = strlen(name);
        if (!is_project_db_file(name, len)) {
            continue;
        }
        char full_path[CBM_SZ_2K];
        snprintf(full_path, sizeof(full_path), "%s/%s", dir_path, name);
        int64_t size_bytes = cbm_file_size(full_path);
        if (size_bytes < 0) {
            continue;
        }
        mcp_project_record_t record = {0};
        project_record_status_t read_status =
            read_project_record_identity(dir_path, name, size_bytes, &record);
        if (read_status == PROJECT_RECORD_OOM) {
            oom = true;
            break;
        }
        if (read_status != PROJECT_RECORD_OK) {
            continue;