In docs/src/user-docs/quick-start/clp-text.md around lines 32 to 43, the fenced
code block ending at line 42 needs a blank line before the closing ::: directive
on line 43 to satisfy MD031; insert a single empty line between the closing ```
and the subsequent closing `:::` so the document has a blank line after the
fenced code block and before the directive.

#!/bin/bash
# Create GitHub issue to track updating webui settings JSON files

gh issue create \
  --repo y-scope/clp \
  --title "Update webui settings JSON files to reflect CLP-JSON as default flavor" \
  --body "The webui settings JSON files, whose default values are used at development time, should be updated to reflect the new default flavor (CLP-JSON instead of CLP Text).

This follows the change in PR #1572 where the default \`storage_engine\` and \`query_engine\` were changed from \`clp\` to \`clp-s\`.

**Related:**
- PR: https://github.com/y-scope/clp/pull/1572
- Comment: https://github.com/y-scope/clp/pull/1572#discussion_r2517681254
- Requested by: @junhaoliao" \
  --assignee junhaoliao

def get_config_value(config, key):
    """
    Gets a value from the given dictionary using a dot-separated configuration
    key, where each dot represents a deeper dictionary. NOTE: This method does
    not support keys that contain dots since that is indistinguishable from a
    deeper dictionary.

    :param config:
    :param key:
    """
    singular_keys = key.split(".")
    current_config = config
    for current_key in singular_keys:
        current_config = current_config[current_key]
    return current_config

def make_config_path_absolute(default_root: pathlib.Path, config_path: pathlib.Path):
    """
    Turns relative paths into absolute paths by prefixing them with the
    default_root

    :param default_root:
    :param config_path:
    """
    if config_path.is_absolute():
        return config_path
    else:
        return default_root / config_path

def read_yaml_config_file(yaml_config_file_path: pathlib.Path):
    with open(yaml_config_file_path, "r") as yaml_config_file:
        try:
            config = yaml.load(yaml_config_file, Loader=yaml.CSafeLoader)
        except ParserError as ex:
            raise ValueError(f"Unable to parse configuration from {yaml_config_file_path}: {ex}")
    return config

def resolve_host_path_in_container(host_path: pathlib.Path) -> pathlib.Path:
    """
    Resolves a host path and translates it into its container-mount equivalent absolute path. See
    `resolve_host_path` for details about the resolution.

    :param host_path: The host path.
    :return: The translated path (with /mnt/host prefix).
    """
    host_path = host_path.expanduser()

    if not host_path.is_absolute():
        pwd_host = os.getenv("CLP_PWD_HOST")
        if pwd_host is None:
            raise ValueError("Relative host path provided but CLP_PWD_HOST is not set.")
        host_path = pathlib.Path(pwd_host) / host_path
        host_path = host_path.absolute()

    resolved_path = _resolve_symlinks_in_path(host_path)
    if resolved_path is not None:
        return resolved_path

    return CONTAINER_DIR_FOR_HOST_ROOT / host_path.relative_to("/")

def validate_path_could_be_dir(path: pathlib.Path):
    part = path
    while True:
        if part.exists():
            if not part.is_dir():
                raise ValueError(f"{part} is not a directory.")
            return
        part = part.parent

def serialize_path(path: pathlib.Path) -> str:
    """
    Serializes a `pathlib.Path` to its string representation.

    :param path:
    :return: The string representation of the path.
    """
    return str(path)

def serialize_str_enum(member: StrEnum) -> str:
    """
    Serializes a `strenum.StrEnum` member to its underlying value.

    :param member:
    :return: The underlying string value of the enum member.
    """
    return member.value

Learnt from: junhaoliao
Repo: y-scope/clp PR: 1178
File: components/clp-py-utils/clp_py_utils/clp_config.py:47-47
Timestamp: 2025-10-07T07:54:32.427Z
Learning: In components/clp-py-utils/clp_py_utils/clp_config.py, the CONTAINER_AWS_CONFIG_DIRECTORY constant is intentionally set to pathlib.Path("/") / ".aws" (i.e., `/.aws`) rather than a user-specific home directory. This hardcoded path is part of the container orchestration design.

Learnt from: haiqi96
Repo: y-scope/clp PR: 0
File: :0-0
Timestamp: 2025-07-29T14:04:13.769Z
Learning: User haiqi96 requested creating a GitHub issue to document a bug fix from PR #1136, which addressed MySQL compatibility issues with invalid SQL CAST operations in the WebUI component.

Learnt from: Bill-hbrhbr
Repo: y-scope/clp PR: 1122
File: components/core/src/clp/clp/CMakeLists.txt:175-195
Timestamp: 2025-07-23T09:54:45.185Z
Learning: In the CLP project, when reviewing CMakeLists.txt changes that introduce new compression library dependencies (BZip2, LibLZMA, LZ4, ZLIB), the team prefers to address conditional linking improvements in separate PRs rather than expanding the scope of focused migration PRs like the LibArchive task-based installation migration.

Learnt from: Bill-hbrhbr
Repo: y-scope/clp PR: 1156
File: components/core/CMakeLists.txt:772-772
Timestamp: 2025-08-09T04:07:27.083Z
Learning: In the CLP project's CMakeLists.txt, when reviewing changes related to the ${zstd_TARGET} variable usage in test linking, the team is planning a refactoring PR to improve this mechanism. Guards for undefined target variables should be deferred to that separate PR rather than being added in focused dependency migration PRs.

Learnt from: junhaoliao
Repo: y-scope/clp PR: 0
File: :0-0
Timestamp: 2025-10-22T21:02:31.113Z
Learning: Repository y-scope/clp: Maintain deterministic CI/builds for Rust; add a check to verify Cargo.lock is in sync with Cargo.toml without updating dependencies (non-mutating verification in clp-rust-checks workflow).

Learnt from: junhaoliao
Repo: y-scope/clp PR: 1405
File: components/clp-package-utils/pyproject.toml:5-15
Timestamp: 2025-10-13T03:24:35.074Z
Learning: In the y-scope/clp repository, the Python 3.9 to 3.10 version requirement change was intentionally deferred to a separate PR (after PR #1405) to reduce review effort, as decided in an offline discussion between junhaoliao and kirkrodrigues.