0e63a1bc5c
`hermes config set gateway.discord.gateway_restart_notification true` wrote the
typo into config.yaml and only then printed the "not a recognized config key — it
was saved anyway" notice (#112003). Under a KNOWN section an unknown sub-key can
only be a typo, so `set_config_value` now exits non-zero via `_exit_invalid`
before reading or writing config.yaml, with the did-you-mean hint.
Scope preserved from ed3a0b3 (warn-after-write): unknown TOP-LEVEL keys are
still written with the post-write notice, because top-level scalars are bridged
into os.environ for skills/external apps and that namespace is open by design;
the `_OPEN_SUBKEY_TOP_LEVEL_KEYS` / platform-container exemptions in
`_validate_config_key` are untouched, and `--force` keeps writing anything. This
is the fail-fast piece the maintainer scoped in the close comment on #111133.
`_validate_config_key` also suggests the path minus its wrong prefix
(`gateway.discord.x` -> `discord.x`) when no same-level sibling is close; the
headline typo previously produced no hint at all.
Docs: cli-commands.md `set`/`unset` rows, configuration.md tip, `--force` help.
Co-authored-by: KoNit-K <124019182+KoNit-K@users.noreply.github.com>
45 lines
2.1 KiB
Python
45 lines
2.1 KiB
Python
"""``hermes config`` subcommand parser."""
|
|
|
|
from __future__ import annotations
|
|
|
|
from typing import Callable
|
|
|
|
from hermes_cli.subcommands._shared import add_json_flag
|
|
|
|
|
|
def build_config_parser(subparsers, *, cmd_config: Callable) -> None:
|
|
"""Attach the ``config`` subcommand to ``subparsers``."""
|
|
config_parser = subparsers.add_parser(
|
|
"config", help="View and edit configuration",
|
|
description="Manage Hermes Agent configuration")
|
|
config_subparsers = config_parser.add_subparsers(dest="config_command")
|
|
|
|
config_subparsers.add_parser("show", help="Show current configuration")
|
|
config_subparsers.add_parser("edit", help="Open config file in editor")
|
|
|
|
config_get = config_subparsers.add_parser("get", help="Print a resolved configuration value")
|
|
config_get.add_argument("key", nargs="?", help="Configuration key (e.g., model)")
|
|
add_json_flag(config_get, "Print value as JSON")
|
|
config_get.add_argument(
|
|
"--raw", action="store_true",
|
|
help="Print credential values unmasked (default masks api_key/token/secret-shaped values)")
|
|
|
|
config_set = config_subparsers.add_parser("set", help="Set a configuration value")
|
|
config_set.add_argument(
|
|
"key", nargs="?", help="Configuration key (e.g., model, terminal.backend)")
|
|
config_set.add_argument("value", nargs="?", help="Value to set")
|
|
config_set.add_argument(
|
|
"--force", action="store_true",
|
|
help="Write a key the running version doesn't recognize: an unknown path under a known "
|
|
"section is otherwise refused, and an unknown top-level key is written with a notice.")
|
|
|
|
config_unset = config_subparsers.add_parser("unset", help="Remove a configuration value")
|
|
config_unset.add_argument("key", nargs="?", help="Configuration key to remove")
|
|
|
|
config_subparsers.add_parser("path", help="Print config file path")
|
|
config_subparsers.add_parser("env-path", help="Print .env file path")
|
|
config_subparsers.add_parser("check", help="Check for missing/outdated config")
|
|
config_subparsers.add_parser("migrate", help="Update config with new options")
|
|
|
|
config_parser.set_defaults(func=cmd_config)
|