elemctl 0.43.0__tar.gz → 0.43.2__tar.gz

{elemctl-0.43.0 → elemctl-0.43.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: elemctl
-Version: 0.43.0
+Version: 0.43.2
 Summary: CLI, MCP server and library for the Console API v2 of the 1C:Enterprise.Element platform (1cmycloud): applications, builds from source, one-command deploy with verification, a compile probe
 Author: KeyFire
 License-Expression: MIT
@@ -98,7 +98,7 @@ elemctl takes the connection credentials from environment variables or from a `.
 
 | Variable | Purpose |
 |---|---|
-| `ELEMENT_BASE_URL` | the platform base URL, e.g. `https://1cmycloud.com` |
+| `ELEMENT_BASE_URL` | the platform base URL starting with `http://` or `https://`, e.g. `https://1cmycloud.com` |
 | `ELEMENT_CLIENT_ID` | Client-Id used to obtain a token |
 | `ELEMENT_CLIENT_SECRET` | Client-Secret |
 | `ELEMENT_APP_ID` | default application (optional) |

{elemctl-0.43.0 → elemctl-0.43.2}/README.md

@@ -66,7 +66,7 @@ elemctl takes the connection credentials from environment variables or from a `.
 
 | Variable | Purpose |
 |---|---|
-| `ELEMENT_BASE_URL` | the platform base URL, e.g. `https://1cmycloud.com` |
+| `ELEMENT_BASE_URL` | the platform base URL starting with `http://` or `https://`, e.g. `https://1cmycloud.com` |
 | `ELEMENT_CLIENT_ID` | Client-Id used to obtain a token |
 | `ELEMENT_CLIENT_SECRET` | Client-Secret |
 | `ELEMENT_APP_ID` | default application (optional) |

{elemctl-0.43.0 → elemctl-0.43.2}/docs/SPEC.md

@@ -26,7 +26,7 @@ Environment variables:
 
 | Variable | Meaning | Required |
 |---|---|---|
-| `ELEMENT_BASE_URL` | platform base URL, e.g. `https://1cmycloud.com` | yes |
+| `ELEMENT_BASE_URL` | platform base URL starting with `http://` or `https://`, e.g. `https://1cmycloud.com` | yes |
 | `ELEMENT_CLIENT_ID` | Client-Id for obtaining the token | yes |
 | `ELEMENT_CLIENT_SECRET` | Client-Secret | yes |
 | `ELEMENT_APP_ID` | default application | no |
@@ -36,7 +36,7 @@ Environment variables:
 | `ELEMENT_TLS_STRICT` | strict RFC 5280 certificate checks; `true` by default | no |
 | `ELEMENT_TLS_VERIFY` | certificate and hostname verification; `true` by default | no |
 
-.env format: `KEY=VALUE` lines. Empty lines and lines starting with `#` are skipped. A leading `export ` prefix is allowed, and the value may be wrapped in single or double quotes. The encoding is UTF-8 and a BOM is possible, so read the file as `utf-8-sig`. A trailing slash in `ELEMENT_BASE_URL` is trimmed.
+.env format: `KEY=VALUE` lines. Empty lines and lines starting with `#` are skipped. A leading `export ` prefix is allowed, and the value may be wrapped in single or double quotes. The encoding is UTF-8 and a BOM is possible, so read the file as `utf-8-sig`. A trailing slash in `ELEMENT_BASE_URL` is trimmed. A nonempty base URL must start with `http://` or `https://`.
 
 ## 3. Authentication
 

{elemctl-0.43.0 → elemctl-0.43.2}/docs/SPEC.ru.md

@@ -37,7 +37,7 @@ README.md, .env.example и .gitignore заданы и не меняются.
 
 | Переменная | Смысл | Обязательна |
 |---|---|---|
-| `ELEMENT_BASE_URL` | базовый URL платформы, например `https://1cmycloud.com` | да |
+| `ELEMENT_BASE_URL` | базовый URL платформы с `http://` или `https://`, например `https://1cmycloud.com` | да |
 | `ELEMENT_CLIENT_ID` | Client-Id для получения токена | да |
 | `ELEMENT_CLIENT_SECRET` | Client-Secret | да |
 | `ELEMENT_APP_ID` | приложение по умолчанию | нет |
@@ -50,7 +50,8 @@ README.md, .env.example и .gitignore заданы и не меняются.
 Формат .env: строки `KEY=VALUE`. Пустые строки и строки, начинающиеся с `#`,
 пропускаются. Перед именем допускается префикс `export `, а значение можно взять
 в одинарные или двойные кавычки. Кодировка UTF-8, возможен BOM, поэтому читать
-надо как `utf-8-sig`. Хвостовой слэш у `ELEMENT_BASE_URL` обрезается.
+надо как `utf-8-sig`. Хвостовой слэш у `ELEMENT_BASE_URL` обрезается. Непустой базовый URL
+должен начинаться с `http://` или `https://`.
 
 ## 3. Аутентификация
 

{elemctl-0.43.0 → elemctl-0.43.2}/docs/changelog.md

@@ -21,6 +21,22 @@ entry either – say what the behaviour was, not which id or response field was
 The link is written by `python scripts/changelog-link.py <number>`, which rebuilds the generated
 pages of the site in the same run – writing it by hand is how the mirrors get left behind.
 
+## 2026-09-23 – 0.43.2
+
+### Changed
+- Python comments and docstrings consistently use hyphens. Ordinary string literals remain unchanged.
+  ([#40](https://github.com/keyfire/elemctl/pull/40))
+
+## 2026-09-22 – 0.43.1
+
+### Fixed
+- **`self-update` reports an incomplete PyPI response without touching the installed package.**
+  The simple index, metadata and wheel downloads missed HTTP parser failures, so an interrupted
+  response could end in a traceback. ([#38](https://github.com/keyfire/elemctl/pull/38))
+- **Connection setup rejects a base URL without an HTTP scheme.** An address without `http://`
+  or `https://` used to reach `urllib` and fail with a raw `ValueError`.
+  ([#38](https://github.com/keyfire/elemctl/pull/38))
+
 ## 2026-09-19 – 0.43.0
 
 ### Added

{elemctl-0.43.0 → elemctl-0.43.2}/docs/changelog.ru.md

@@ -21,6 +21,23 @@ sidebar:
 Ссылку пишет `python scripts/changelog-link.py <номер>` – он же тут же пересобирает
 сгенерированные страницы сайта: правка руками как раз и оставляет зеркала позади.
 
+## 23.09.2026 – 0.43.2
+
+### Изменено
+- В комментариях и документирующих строках Python используется обычный дефис. Остальные строковые литералы сохранены.
+  ([#40](https://github.com/keyfire/elemctl/pull/40))
+
+## 22.09.2026 – 0.43.1
+
+### Исправлено
+- **`self-update` сообщает об оборванном ответе PyPI и не затрагивает установленный пакет.**
+  Чтение индекса Simple, метаданных и колеса не ловило ошибки синтаксического анализатора HTTP,
+  поэтому оборванный ответ мог закончиться трассировкой.
+  ([#38](https://github.com/keyfire/elemctl/pull/38))
+- **Настройка подключения отказывает базовому URL без схемы HTTP.** Адрес без `http://` или
+  `https://` доходил до `urllib` и заканчивался необработанным `ValueError`.
+  ([#38](https://github.com/keyfire/elemctl/pull/38))
+
 ## 19.09.2026 – 0.43.0
 
 ### Добавлено

{elemctl-0.43.0 → elemctl-0.43.2}/docs/config.md

@@ -13,7 +13,7 @@ elemctl takes the connection credentials from environment variables or from a `.
 
 | Variable | Purpose |
 |---|---|
-| `ELEMENT_BASE_URL` | the platform base URL, e.g. `https://1cmycloud.com` |
+| `ELEMENT_BASE_URL` | the platform base URL starting with `http://` or `https://`, e.g. `https://1cmycloud.com` |
 | `ELEMENT_CLIENT_ID` | Client-Id used to obtain a token |
 | `ELEMENT_CLIENT_SECRET` | Client-Secret |
 | `ELEMENT_APP_ID` | default application (optional) |

{elemctl-0.43.0 → elemctl-0.43.2}/docs/config.ru.md

@@ -14,7 +14,7 @@ sidebar:
 
 | Переменная | Назначение |
 |---|---|
-| `ELEMENT_BASE_URL` | базовый URL платформы, например `https://1cmycloud.com` |
+| `ELEMENT_BASE_URL` | базовый URL платформы с `http://` или `https://`, например `https://1cmycloud.com` |
 | `ELEMENT_CLIENT_ID` | Client-Id для получения токена |
 | `ELEMENT_CLIENT_SECRET` | Client-Secret |
 | `ELEMENT_APP_ID` | приложение по умолчанию (необязательно) |

{elemctl-0.43.0 → elemctl-0.43.2}/src/elemctl/__init__.py

@@ -1,4 +1,4 @@
-"""elemctl – a CLI, an MCP server and a library for Console API v2 of the
+"""elemctl - a CLI, an MCP server and a library for Console API v2 of the
 1C:Enterprise.Element platform (1cmycloud).
 
 Public API of the library:
@@ -18,7 +18,7 @@ from .errors import (
     TransportError,
 )
 
-__version__ = "0.43.0"
+__version__ = "0.43.2"
 
 __all__ = [
     "ApiError",

{elemctl-0.43.0 → elemctl-0.43.2}/src/elemctl/build.py

@@ -60,7 +60,7 @@ SOAP_CLIENT_KINDS = ("КлиентSoapСервиса", "SoapServiceClient")
 # by extension.
 RESOURCES_DIR = "Ресурсы"
 
-# Directories excluded entirely (plus every hidden one – starting with a dot).
+# Directories excluded entirely (plus every hidden one - starting with a dot).
 EXCLUDED_DIRS = {".git", ".claude", ".github", "__pycache__", "node_modules", ".venv"}
 
 # Files excluded by exact name.
@@ -69,7 +69,7 @@ EXCLUDED_FILES = {".gitignore", ".env", ".DS_Store"}
 # Files excluded by extension (prebuilt build archives).
 EXCLUDED_SUFFIXES = (".xasm", ".xlib")
 
-# The CI environment variables carrying the run number – the source of the build
+# The CI environment variables carrying the run number - the source of the build
 # version suffix when neither an explicit version nor a last build is given: every
 # CI run happens in a clean working directory, so local numbering would always
 # yield "-1".
@@ -105,9 +105,9 @@ class LibraryRef:
 class BuildResult:
     """The result of a local archive build.
 
-    version_source – where the build version came from: "flag" (set explicitly),
+    version_source - where the build version came from: "flag" (set explicitly),
     "last-build" (auto-increment from the last build), the name of a CI variable
-    (the run number from the environment) or "default". dirty_files – the files
+    (the run number from the environment) or "default". dirty_files - the files
     with uncommitted changes in the project directory; None when git is
     unavailable or the directory is not inside a repository.
     """
@@ -132,7 +132,7 @@ class BuildResult:
 def parse_flat_yaml(text):
     """Parse the flat top-level "key: value" pairs of a YAML text.
 
-    Nested lines (the indented ones), blank lines and comments are skipped –
+    Nested lines (the indented ones), blank lines and comments are skipped -
     for Проект.yaml that is enough.
     """
     values = {}
@@ -334,7 +334,7 @@ def collect_project_files(project_dir):
 
     Outside the resource directories an allowlist of extensions applies; inside a
     `Ресурсы` directory (at any level, including its subdirectories) files of any
-    extension are taken – a resource may be an arbitrary file: .pdf, .htm, .mxl etc.
+    extension are taken - a resource may be an arbitrary file: .pdf, .htm, .mxl etc.
     """
     return collect_with_skipped(project_dir)[0]
 
@@ -432,7 +432,7 @@ def _detached_branch(environ=None):
 def git_metadata(project_dir, environ=None):
     """The commit hash and the branch name of the git repository holding the project.
 
-    When git is unavailable (no command, not a repository) – empty strings.
+    When git is unavailable (no command, not a repository) - empty strings.
 
     A detached checkout is answered by the CI, not by git: `rev-parse --abbrev-ref HEAD`
     says the literal `HEAD` there, and that is what every assembly built on a runner used
@@ -452,7 +452,7 @@ def git_dirty_files(project_dir):
 
     A build captures the disk as it is at the moment it starts, so a divergence
     from HEAD has to be visible to the caller. Returned is the list of paths from
-    git status --porcelain limited to the directory; None – when git is unavailable
+    git status --porcelain limited to the directory; None - when git is unavailable
     or the directory is not inside a repository (as opposed to an empty list,
     meaning "clean").
     """
@@ -510,8 +510,8 @@ def build_assembly(
 
     The version: the explicit version, otherwise an auto-increment from
     last_build_version, otherwise a suffix taken from the CI run number (the
-    CI_BUILD_NUMBER_VARS variables), and with none of that – "{base version}-1".
-    branch and commit override the git metadata (None – take it from git). kind
+    CI_BUILD_NUMBER_VARS variables), and with none of that - "{base version}-1".
+    branch and commit override the git metadata (None - take it from git). kind
     overrides the project kind ("application"/"library").
     """
     directory = find_project_dir(project_dir) if project_dir else find_project_dir()
@@ -643,10 +643,10 @@ def read_assembly_project(path):
 
 
 def inspect_assembly(path):
-    """Inspect a prebuilt assembly archive (.xasm/.xlib) – the inverse of build_assembly.
+    """Inspect a prebuilt assembly archive (.xasm/.xlib) - the inverse of build_assembly.
 
     Returns the manifest, the project properties, its subsystems and the types
-    available to the project that plugged it in (ОбластьВидимости: Глобально) –
+    available to the project that plugged it in (ОбластьВидимости: Глобально) -
     with their qualified names. The namespace of a type is
     {vendor}::{name}::{subsystem}[::{package}], where a package is a nested
     directory of a subsystem (a package has no descriptor file of its own).
@@ -686,7 +686,7 @@ def inspect_assembly(path):
         "vendor": vendor,
         "name": name,
         "version": manifest.get("Version", ""),
-        # There is no ВерсияТехнологии in Проект.yaml – compatibility is set by
+        # There is no ВерсияТехнологии in Проект.yaml - compatibility is set by
         # РежимСовместимости, and it is exactly what is matched against the target project.
         "compatibility": descriptor_value(project, "РежимСовместимости", "CompatibilityMode"),
         "representation": descriptor_value(project, "Представление", "Presentation"),
@@ -759,7 +759,7 @@ def _archive_elements(archive, names, prefix):
 
 
 def _subsystems(elements, vendor, name):
-    """The project's subsystems and their packages – from the directory layout.
+    """The project's subsystems and their packages - from the directory layout.
 
     A subsystem is a first-level directory; Подсистема.yaml is optional (a library
     may have none at all), so it cannot be relied upon.

{elemctl-0.43.0 → elemctl-0.43.2}/src/elemctl/cli.py

@@ -63,7 +63,7 @@ _answer_stream = None
 def _emit(data):
     """Print the answer and flush it immediately.
 
-    Off a terminal Python block-buffers stdout, while stderr goes through right away – a
+    Off a terminal Python block-buffers stdout, while stderr goes through right away - a
     caller who merges the streams (`2>&1`, or stderr=STDOUT, a plain way to capture "everything
     the tool printed" for a log) then saw a later _progress line overtake an _emit that ran
     first in the source, and a parser hunting for the first brace found a summary line instead.
@@ -80,7 +80,7 @@ def _json_only():
     """--json: only the answer reaches stdout, everything else goes to stderr.
 
     The promise is kept by the streams themselves rather than by discipline: a
-    print of a plugin command, a warning of a library, a stray debug line – all of
+    print of a plugin command, a warning of a library, a stray debug line - all of
     them land on stderr, because for the duration of the call sys.stdout IS stderr.
     _emit keeps writing to the real stdout, which is remembered here.
     """
@@ -95,7 +95,7 @@ def _json_only():
 
 def _progress(message):
     # stderr is already line-buffered on every supported Python, so this changes nothing in
-    # practice – it is here so the order _emit relies on is an explicit guarantee in the code,
+    # practice - it is here so the order _emit relies on is an explicit guarantee in the code,
     # not an assumption about the interpreter's default that the next reader has to go verify.
     print(message, file=sys.stderr)
     sys.stderr.flush()
@@ -108,7 +108,7 @@ def _fail(payload):
 
 
 def _reconfigure_streams():
-    """Switch the console output to UTF-8 – otherwise Cyrillic breaks on Windows."""
+    """Switch the console output to UTF-8 - otherwise Cyrillic breaks on Windows."""
     for stream in (sys.stdout, sys.stderr):
         reconfigure = getattr(stream, "reconfigure", None)
         if reconfigure is not None:
@@ -169,14 +169,14 @@ def _refuse_connection_options(args, command):
 
     `build` and `inspect` never reach the platform: the archive is assembled from
     the sources on disk, and no version number is reserved on the server. The
-    options used to be accepted and quietly dropped – and a call that carries
+    options used to be accepted and quietly dropped - and a call that carries
     `--env-file` LOOKS like a build bound to a stand, which twice left the reader
     asking whether the build talks to the server after all.
 
     A refusal rather than a warning, for three reasons. Nothing stops working:
     the options changed nothing, so the only calls it breaks are the ones that
     already meant something else. A warning would land on stderr, next to the
-    progress lines, where a CI log buries it – and silence of exactly that kind is
+    progress lines, where a CI log buries it - and silence of exactly that kind is
     what caused the doubt. And the refusal answers the question the caller really
     had: it says outright that a local build does not go to the platform, and
     names the commands that do.
@@ -262,7 +262,7 @@ def cmd_apps_find(args):
 
     The exit code is 0 in both cases: the found field carries the verdict. A non-zero exit
     code means the request itself failed (no access, network, configuration) and comes with
-    JSON carrying an error field on stderr – otherwise the caller cannot tell "there is no
+    JSON carrying an error field on stderr - otherwise the caller cannot tell "there is no
     stand" from "we failed to ask".
 
     Deleted applications (status Deleted) are skipped by default, so that the id found is fit
@@ -401,7 +401,7 @@ def _report_sign_in(card):
     A stand nobody can get into is not a ready stand, and the way in is not
     guessable: the accounts used elsewhere do not work in a fresh application
     (client.sign_in_hint). The text goes to stderr, where the rest
-    of the progress goes, and the machine-readable twin goes into the JSON – an
+    of the progress goes, and the machine-readable twin goes into the JSON - an
     agent reading only stdout must learn it too.
     """
     hint = sign_in_hint(card)
@@ -500,8 +500,8 @@ def cmd_apps_ensure(args):
     """Idempotently bring an application with the given name into existence.
 
     It looks the application up by the rules of apps find (deleted ones, in
-    status Deleted, do not count): if it is already there – it does nothing and
-    returns created: false; if it is not – it creates one from the creation flags
+    status Deleted, do not count): if it is already there - it does nothing and
+    returns created: false; if it is not - it creates one from the creation flags
     and returns created: true. An existing application is never re-created:
     delete + create give a new URL and break the external links to the previous
     one. The exit code is 0 in both cases; a failed request is JSON with an error
@@ -690,9 +690,9 @@ def cmd_builds_list(args):
 
     Neither cut is silent, and there are two of them. The tool's own is the limit.
     The platform's is its housekeeping: it deletes the builds nobody uses, whatever
-    their age, so a listing is not the project's history – it is what survived. The
+    their age, so a listing is not the project's history - it is what survived. The
     count line says which of the two the reader is looking at (builds_summary reads
-    that off the gaps in the build numbering), and it is printed always – after the
+    that off the gaps in the build numbering), and it is printed always - after the
     answer, the same order apps list uses: a listing without it was read as "the
     project has exactly these builds", and a caller capturing the two streams as one
     must still find the answer first.
@@ -707,7 +707,7 @@ def cmd_builds_list(args):
     truncated = args.limit > 0 and len(assemblies) > args.limit
     if truncated:
         shown = assemblies[: args.limit]
-    # Counted before --brief reshapes the cards: the whole answer, not the cut one –
+    # Counted before --brief reshapes the cards: the whole answer, not the cut one -
     # what the platform left out is judged by the numbering of everything it did
     # return, and the count of a card does not change when its fields do.
     shown_count = len(shown)
@@ -733,8 +733,8 @@ def cmd_builds_get(args):
 def _upload_target(args, config):
     """The target project of the upload and the source of that choice.
 
-    The sources: "flag" – the --project-id flag, "env" – ELEMENT_PROJECT_ID from
-    the environment or the .env file, None – no project is set, the platform will
+    The sources: "flag" - the --project-id flag, "env" - ELEMENT_PROJECT_ID from
+    the environment or the .env file, None - no project is set, the platform will
     create a new one. The --new-project flag switches the binding from the
     environment off; together with --project-id it is contradictory, which is a
     call error.
@@ -950,7 +950,7 @@ def _user_list_id(client, args):
     """The id of the target user list: from the argument or from the application.
 
     Exactly one of the two is expected. --app takes the application's own list
-    (default-user-list of its card) – that is the everyday case: the settings of
+    (default-user-list of its card) - that is the everyday case: the settings of
     the checklist are made on the list of a particular application, and its
     presentation is named after the application anyway.
     """
@@ -1026,8 +1026,8 @@ def _calculation_rules(args):
 def cmd_user_lists_calculation_rules(args):
     """The rules that build a user from the provider's answer: show the target or write them.
 
-    Without values the command does not pretend to show the rules – the platform does not
-    return them – it names the service they would go to and says why there is nothing to
+    Without values the command does not pretend to show the rules - the platform does not
+    return them - it names the service they would go to and says why there is nothing to
     show. Writing reports honestly what was confirmed and what could not be.
     """
     client = make_client(_config(args))
@@ -1061,7 +1061,7 @@ def cmd_user_lists_calculation_rules(args):
 
 
 def cmd_user_lists_password_login(args):
-    """Signing in with a login and a password – the account service of type Local.
+    """Signing in with a login and a password - the account service of type Local.
 
     Without a flag the command answers with the current state; the answer says
     `enabled: null` when the list has no such service at all (nothing to sign in
@@ -1209,7 +1209,7 @@ def cmd_tech_set(args):
 def cmd_debug_adapter(args):
     """The path to the platform debug adapter directory brought by the plugin.
 
-    The directory holds a repo/ subdirectory with the jar files of the adapter – that is
+    The directory holds a repo/ subdirectory with the jar files of the adapter - that is
     the ready value of the xbsl.debug.adapterPath setting for the VS Code extension. A
     missing plugin is an answer (found: false, code 0), not an error: a non-zero code
     would mean a failure.
@@ -1223,10 +1223,10 @@ def cmd_debug_adapter(args):
 
 
 def cmd_plugins(args):
-    """Plugin diagnostics: what the plugins bring – adapter directories and commands.
+    """Plugin diagnostics: what the plugins bring - adapter directories and commands.
 
     The adapter directories are listed jar-less ones included (that is exactly
-    what a diagnostic is for), the commands – with the entry point they arrived
+    what a diagnostic is for), the commands - with the entry point they arrived
     through and whether they are exposed to MCP. The failures name the plugins
     left out and the reason: a plugin that did not load, or a command that would
     have taken over a name of the core.
@@ -1271,15 +1271,15 @@ def cmd_mcp(args):
         from . import mcp_server
     except ImportError:
         raise ElemctlError(i18n.t("cli.mcp-extra-required"))
-    # A bad --env-file still fails right here, before the server starts – the same check
+    # A bad --env-file still fails right here, before the server starts - the same check
     # Config.from_env would raise on the first call, just not deferred to it: a typo in a
     # path given explicitly on this command line is worth knowing about immediately, not
     # minutes into a session. Other default-stand configuration problems (a bad
     # ELEMENT_TLS_VERIFY, credentials missing entirely) are NOT resolved here on purpose: not
     # _config(args), which used to build a whole Config up front and hand it to mcp_server as
-    # a ready object – that pinned it for the life of the process, so the default stand's
+    # a ready object - that pinned it for the life of the process, so the default stand's
     # .env, edited after the server started, was never re-read. Only the genuine overrides
-    # (the flags actually given – base URL, client id and the rest) and --env-file, if any,
+    # (the flags actually given - base URL, client id and the rest) and --env-file, if any,
     # are passed instead; every call still without its own env_file rebuilds from the file on
     # an edit, the overrides applied on top each time.
     if args.env_file:
@@ -1348,7 +1348,7 @@ class _AliasedPositional(argparse.Action):
 
     argparse hands an optional positional its own default when the command line carried
     none, and that default would land on the dest the key form had just filled. Here the
-    default is _MISSING, and seeing it means write nothing at all – the dest keeps what
+    default is _MISSING, and seeing it means write nothing at all - the dest keeps what
     the key form put there, or stays out of the namespace when neither form was given.
     """
 
@@ -1363,7 +1363,7 @@ class _AliasedPositional(argparse.Action):
 def _add_aliased_positional(parser, argument):
     """A positional plugin argument and its CLI-only key synonym (Argument.cli_alias).
 
-    The MCP tool keeps the one parameter it always had (see mcp_server._plugin_tool) –
+    The MCP tool keeps the one parameter it always had (see mcp_server._plugin_tool) -
     the alias changes what THIS parser accepts, nothing about the declared arguments.
     A mutually exclusive group lets either form fill the same dest: both at once is a
     parser refusal ("not allowed with argument ..."), and required carries over to the
@@ -1371,7 +1371,7 @@ def _add_aliased_positional(parser, argument):
 
     Neither half writes a default: an option left at its own implicit default of None
     would win the namespace the moment the parser builds it (the option is added second,
-    and it is not the positional's nargs="?" default that argparse falls back to first) –
+    and it is not the positional's nargs="?" default that argparse falls back to first) -
     silently overriding a non-None default the plugin declared. With both halves quiet the
     dest stays out of the namespace whenever neither form is given, and _plugin_handler
     already falls back to Argument.value_default for exactly that case, the same way it
@@ -1612,7 +1612,7 @@ def build_parser():
                         version=f"elemctl {__version__}")
 
     # title= renders the list under a "commands:" heading instead of argparse's default
-    # "positional arguments: command" – the same heading the sibling tools use.
+    # "positional arguments: command" - the same heading the sibling tools use.
     sub = parser.add_subparsers(
         dest="command",
         metavar=i18n.t("cli.help.command-metavar"),