Function save_initial_user_settings

src/cocoindex_code/settings.py:560–590

Write the initial global_settings.yml with comment hints and env examples. Only used by `ccc init` on first-time setup. Emits only the `embedding:` block from the input; the `envs:` section is a commented-out template. Subsequent programmatic writes use `save_user_settings` and do not

(
    embedding: EmbeddingSettings,
    defaults_applied: bool,
)

def save_initial_user_settings(
    embedding: EmbeddingSettings,
    defaults_applied: bool,
) -> Path:
    """Write the initial global_settings.yml with comment hints and env examples.

    Only used by `ccc init` on first-time setup. Emits only the `embedding:`
    block from the input; the `envs:` section is a commented-out template.
    Subsequent programmatic writes use `save_user_settings` and do not
    preserve comments.

    When ``defaults_applied`` is False, a provider-specific commented-out
    template for ``indexing_params`` / ``query_params`` is inserted under the
    ``embedding:`` block so the user sees the fields exist.
    """
    emb_block = _yaml.safe_dump(
        {"embedding": _embedding_settings_to_dict(embedding)},
        default_flow_style=False,
        sort_keys=False,
    )
    content = _INITIAL_HEADER + emb_block
    if not defaults_applied:
        hint = _PARAMS_COMMENT_BY_PROVIDER.get(embedding.provider)
        if hint is not None:
            content += hint
    content += _INITIAL_ENVS_COMMENT

    path = user_settings_path()
    path.parent.mkdir(parents=True, exist_ok=True)
    path.write_text(content)
    return path


def load_project_settings(project_root: Path) -> ProjectSettings: