elemctl 0.43.2__tar.gz → 0.44.0__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: elemctl
-Version: 0.43.2
+Version: 0.44.0
 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

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

@@ -293,7 +293,15 @@ Commands, with the significant flags in parentheses:
 - `probe [--project-dir --output --build-version --name --space-id --keep
   --require-clean]` – an isolated compilation check of the sources: build ->
   upload -> a throwaway application (that is the compilation, section 6.10) ->
-  errors with file and position -> cleanup. `ELEMENT_APP_ID` and
+  errors with file and position -> cleanup. Before the build the manifest is
+  checked for what the server needs to take a probe: `Представление`
+  (`Presentation`), without which the console refuses the upload with a bare 500;
+  `ЯзыкРазработки` (`DevelopmentLanguage`), a required property without which no
+  application is created; and `ЯзыкиЛокализации` (`LocalizationLanguages`)
+  whenever `ЯзыкПоУмолчанию` (`DefaultLanguage`) is set, since the server refuses
+  that pair without naming the cause. A missing key stops the probe before
+  anything is built or uploaded, and the error names every such key with the
+  line to add, in the spelling the manifest uses. `ELEMENT_APP_ID` and
   `ELEMENT_PROJECT_ID` are deliberately left unused: the probe must not be able to
   reach the working application, and the target project is chosen by the platform
   out of the vendor and the name of the manifest (section 6.8). The default build

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

@@ -668,7 +668,15 @@ stdout перенаправляется в stderr, и в настоящий stdo
 - `probe [--project-dir --output --build-version --name --space-id --keep
   --require-clean]` - изолированная проверка компиляции исходников: сборка ->
   загрузка -> одноразовое приложение (это и есть компиляция, п. 6.10) -> ошибки
-  с файлом и позицией -> уборка. `ELEMENT_APP_ID` и `ELEMENT_PROJECT_ID`
+  с файлом и позицией -> уборка. До сборки манифест проверяется на то, без чего
+  сервер пробник не примет. Это `Представление` (`Presentation`): без него
+  консоль отвечает на загрузку 500 без объяснения. Это `ЯзыкРазработки`
+  (`DevelopmentLanguage`): обязательное свойство, без него приложение не
+  создаётся. И это `ЯзыкиЛокализации` (`LocalizationLanguages`), когда задан
+  `ЯзыкПоУмолчанию` (`DefaultLanguage`): такую пару сервер отклоняет, не называя
+  причины. Недостающий ключ останавливает пробник до сборки и загрузки, а ошибка
+  называет каждый такой ключ вместе со строкой, которую нужно добавить, в
+  написании самого манифеста. `ELEMENT_APP_ID` и `ELEMENT_PROJECT_ID`
   намеренно не используются: у пробника не должно быть возможности достать
   рабочее приложение, а проект-цель выбирает сама платформа по поставщику и
   имени манифеста (п. 6.8). Версия сборки по умолчанию - `{база}-probe-{токен}`.

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

@@ -21,6 +21,15 @@ 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-24 – 0.44.0
+
+### Added
+- **`probe` checks the manifest before it builds anything.** A probe project without
+  `Представление` was refused by the console with a bare 500, one without `ЯзыкРазработки`
+  never got an application, and a `ЯзыкПоУмолчанию` without `ЯзыкиЛокализации` was refused
+  with no cause named. Now the probe stops before the build and names each missing key with
+  the line to add. ([#41](https://github.com/keyfire/elemctl/pull/41))
+
 ## 2026-09-23 – 0.43.2
 
 ### Changed

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

@@ -21,6 +21,15 @@ sidebar:
 Ссылку пишет `python scripts/changelog-link.py <номер>` – он же тут же пересобирает
 сгенерированные страницы сайта: правка руками как раз и оставляет зеркала позади.
 
+## 24.09.2026 – 0.44.0
+
+### Добавлено
+- **`probe` проверяет манифест до сборки.** Проект пробника без `Представление` консоль
+  отклоняла ответом 500 без объяснения, без `ЯзыкРазработки` приложение не создавалось, а
+  `ЯзыкПоУмолчанию` без `ЯзыкиЛокализации` сервер отклонял, не называя причины. Теперь
+  пробник останавливается до сборки и называет каждый недостающий ключ вместе со строкой,
+  которую нужно добавить. ([#41](https://github.com/keyfire/elemctl/pull/41))
+
 ## 23.09.2026 – 0.43.2
 
 ### Изменено

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

@@ -18,7 +18,7 @@ from .errors import (
     TransportError,
 )
 
-__version__ = "0.43.2"
+__version__ = "0.44.0"
 
 __all__ = [
     "ApiError",

{elemctl-0.43.2 → elemctl-0.44.0}/src/elemctl/i18n.py

@@ -933,6 +933,33 @@ MESSAGES = {
         "ru": "уборка: {problem}",
         "en": "cleanup: {problem}",
     },
+    "probe.manifest-incomplete": {
+        "ru": "{file}: сервер не примет этот пробник, поэтому он остановлен до сборки. {problems}",
+        "en": "{file}: the server will not take this probe, so it stopped before the build. "
+              "{problems}",
+    },
+    "probe.manifest-no-presentation": {
+        "ru": "Нет Представление (Presentation): без него консоль отвечает на загрузку сборки "
+              "500 \"Internal exception\" и причины не называет. Нужна строка \"{example}\".",
+        "en": "There is no Представление (Presentation): without it the console answers the "
+              "upload with a 500 \"Internal exception\" and names no cause. The line "
+              "\"{example}\" is needed.",
+    },
+    "probe.manifest-no-development-language": {
+        "ru": "Нет ЯзыкРазработки (DevelopmentLanguage): это обязательное свойство проекта, и без "
+              "него приложение не создаётся. Нужна строка \"{example}\".",
+        "en": "There is no ЯзыкРазработки (DevelopmentLanguage): it is a required property of "
+              "the project, and no application is created without it. The line \"{example}\" "
+              "is needed.",
+    },
+    "probe.manifest-no-localization-languages": {
+        "ru": "ЯзыкПоУмолчанию (DefaultLanguage) задан без ЯзыкиЛокализации "
+              "(LocalizationLanguages): такой проект сервер отклоняет, не называя причины. "
+              "Нужна строка \"{example}\".",
+        "en": "ЯзыкПоУмолчанию (DefaultLanguage) is set without ЯзыкиЛокализации "
+              "(LocalizationLanguages): the server refuses such a project and names no cause. "
+              "The line \"{example}\" is needed.",
+    },
     # -- help: argparse help texts (cli.py) ---------------------------------------
     # CLI help strings. Key: cli.help.<command> or cli.help.<command>-<flag>.
     # Metavars that already read as English (NAME/APP_ID/FILE) are left untranslated.

{elemctl-0.43.2 → elemctl-0.44.0}/src/elemctl/mcp_server.py

@@ -713,7 +713,9 @@ def create_server(config=None, *, overrides=None, env_file=None):
         окружения намеренно не используются. Итог - поле ok; ошибки в errors
         (файл, строка, колонка, окружение, текст), исходные сообщения платформы -
         в messages, итог уборки - в cleanup. keep=true оставляет приложение и
-        сборку на стенде для разбора руками.
+        сборку на стенде для разбора руками. До сборки проверяется Проект.yaml: без
+        Представление, без ЯзыкРазработки или с ЯзыкПоУмолчанию без ЯзыкиЛокализации
+        сервер пробник не примет, и инструмент сразу называет недостающий ключ.
         """
         lines: list[str] = []
         report = probe_project(

{elemctl-0.43.2 → elemctl-0.44.0}/src/elemctl/probe.py

@@ -28,7 +28,13 @@ import uuid
 from dataclasses import dataclass, field
 
 from . import i18n
-from .build import build_assembly, find_project_dir, read_project_meta
+from .build import (
+    build_assembly,
+    descriptor_value,
+    find_project_dir,
+    parse_flat_yaml,
+    read_project_meta,
+)
 from .client import extract_assembly_id, extract_project_id
 from .errors import ApiError, ElemctlError
 
@@ -183,6 +189,52 @@ def compatibility_refusal(messages):
     return ""
 
 
+def manifest_problems(project_file):
+    """What the manifest lacks for the server to take a probe; [] when nothing.
+
+    A hand-written probe project tends to carry only the name, the vendor and the version,
+    and the server answers each missing key in its own unhelpful way. Without
+    `Представление` the console refuses the upload with a bare 500 and names the field only
+    in its own event log. `ЯзыкРазработки` is a required property of the project
+    descriptor: without it no application is created, so a probe can never come out ok. A
+    `ЯзыкПоУмолчанию` without `ЯзыкиЛокализации` is refused with no word about the cause at
+    all. Every key is read in both spellings, and the example of a fix is written in the
+    spelling the manifest itself uses; the project's own name stands in for a presentation.
+    """
+    values = parse_flat_yaml(project_file.read_text(encoding="utf-8-sig"))
+    english = "Name" in values and "Имя" not in values
+
+    def spelled(russian, english_key):
+        return english_key if english else russian
+
+    language = spelled("Русский", "English")
+    problems = []
+    if not descriptor_value(values, "Представление", "Presentation"):
+        name = descriptor_value(values, "Имя", "Name")
+        problems.append(i18n.t(
+            "probe.manifest-no-presentation",
+            example=f"{spelled('Представление', 'Presentation')}: {name}",
+        ))
+    if not descriptor_value(values, "ЯзыкРазработки", "DevelopmentLanguage"):
+        problems.append(i18n.t(
+            "probe.manifest-no-development-language",
+            example=f"{spelled('ЯзыкРазработки', 'DevelopmentLanguage')}: {language}",
+        ))
+    # The list may be written inline or as a nested block; a block leaves the value of the
+    # key itself empty, so the key counts by its presence, and only an empty inline list
+    # counts as no list.
+    languages = [
+        values[key] for key in ("ЯзыкиЛокализации", "LocalizationLanguages") if key in values
+    ]
+    no_list = all(value.replace(" ", "") == "[]" for value in languages)
+    if descriptor_value(values, "ЯзыкПоУмолчанию", "DefaultLanguage") and no_list:
+        problems.append(i18n.t(
+            "probe.manifest-no-localization-languages",
+            example=f"{spelled('ЯзыкиЛокализации', 'LocalizationLanguages')}: [{language}]",
+        ))
+    return problems
+
+
 def _all_lines(messages):
     """Every non-empty line of the messages, in order."""
     return [
@@ -219,6 +271,13 @@ def probe_project(
         token = uuid.uuid4().hex[:8]
 
     meta = read_project_meta(find_project_dir(project_dir) if project_dir else find_project_dir())
+    # Checked before anything is built or uploaded: each of these ends the run on the
+    # server anyway, and the server's own answer does not say which key was missing.
+    problems = manifest_problems(meta.project_file)
+    if problems:
+        raise ElemctlError(i18n.t(
+            "probe.manifest-incomplete", file=meta.project_file, problems=" ".join(problems)
+        ))
     report = ProbeReport(
         project_dir=str(meta.project_dir),
         vendor=meta.vendor,

{elemctl-0.43.2 → elemctl-0.44.0}/src/elemctl.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: elemctl
-Version: 0.43.2
+Version: 0.44.0
 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

{elemctl-0.43.2 → elemctl-0.44.0}/tests/test_i18n.py

@@ -198,6 +198,9 @@ def test_no_russian_string_literals_outside_the_catalog():
         "Реквизиты", "Измерения", "Ид", "Тип", "Длина", "МаксимальнаяДлина",
         # The primitive type names the guard canonicalizes across the spellings.
         "Строка", "Число", "Булево", "Дата", "ДатаВремя", "Время",
+        # The language keys of a descriptor and the value of the language enumeration:
+        # the probe checks the keys and quotes them in the line it asks to add.
+        "ЯзыкРазработки", "ЯзыкПоУмолчанию", "ЯзыкиЛокализации", "Русский",
     }
 
     # Constants that RECOGNIZE the platform's own wording rather than produce ours:

{elemctl-0.43.2 → elemctl-0.44.0}/tests/test_probe.py

@@ -5,7 +5,20 @@ from __future__ import annotations
 import pytest
 
 from elemctl.errors import ApiError, ElemctlError
-from elemctl.probe import PROBE_PREFIX, parse_compilation_errors, probe_project
+from elemctl.probe import PROBE_PREFIX, manifest_problems, parse_compilation_errors, probe_project
+
+
+@pytest.fixture
+def project_factory(project_factory):
+    """A probe project carries the manifest keys the server asks for, unless a test drops one."""
+
+    def make(*args, **kwargs):
+        kwargs.setdefault("presentation", "Пробник")
+        kwargs.setdefault("language", "Русский")
+        return project_factory(*args, **kwargs)
+
+    return make
+
 
 # A task message exactly as the platform gives it: the first line carries the
 # platform's own prefix, the rest are bare.
@@ -403,3 +416,89 @@ def test_the_english_wording_of_the_refusal_is_recognized(project_factory, tmp_p
     report = probe_project(client, project_dir=project_factory(), output_dir=tmp_path / "dist")
 
     assert report.compatibility_refused == "99.0"
+
+
+def _append(project_dir, text):
+    descriptor = project_dir / "Проект.yaml"
+    descriptor.write_text(descriptor.read_text(encoding="utf-8") + text, encoding="utf-8")
+
+
+def test_a_manifest_without_a_presentation_stops_the_probe_before_the_build(
+    project_factory, tmp_path
+):
+    """Without the presentation the console refused the upload with a bare 500.
+
+    The field was named only in the event log of the console, so the probe names it before
+    it builds or uploads anything.
+    """
+    client = FakeProbeClient()
+
+    with pytest.raises(ElemctlError) as caught:
+        probe_project(
+            client, project_dir=project_factory(presentation=""), output_dir=tmp_path / "dist"
+        )
+
+    assert "Представление (Presentation)" in str(caught.value)
+    assert '"Представление: crm"' in str(caught.value)
+    assert client.calls == []
+    assert not (tmp_path / "dist").exists()
+
+
+def test_a_manifest_without_a_development_language_stops_the_probe(project_factory, tmp_path):
+    """The application is never created without it, so the probe could never come out ok."""
+    client = FakeProbeClient()
+
+    with pytest.raises(ElemctlError) as caught:
+        probe_project(
+            client, project_dir=project_factory(language=""), output_dir=tmp_path / "dist"
+        )
+
+    assert "ЯзыкРазработки (DevelopmentLanguage)" in str(caught.value)
+    assert '"ЯзыкРазработки: Русский"' in str(caught.value)
+    assert client.calls == []
+
+
+def test_every_missing_key_is_named_at_once(project_factory):
+    problems = manifest_problems(project_factory(presentation="", language="") / "Проект.yaml")
+
+    assert len(problems) == 2
+
+
+def test_a_default_language_needs_the_list_of_localization_languages(project_factory):
+    """The server refused such a project and pointed at nothing.
+
+    The list may be written inline or as a nested block.
+    """
+    project_dir = project_factory()
+    _append(project_dir, "ЯзыкПоУмолчанию: Русский\n")
+    descriptor = project_dir / "Проект.yaml"
+
+    problems = manifest_problems(descriptor)
+    assert len(problems) == 1 and "ЯзыкиЛокализации (LocalizationLanguages)" in problems[0]
+
+    _append(project_dir, "ЯзыкиЛокализации: []\n")
+    assert len(manifest_problems(descriptor)) == 1
+
+    block = descriptor.read_text(encoding="utf-8").replace(
+        "ЯзыкиЛокализации: []\n", "ЯзыкиЛокализации:\n    - Русский\n"
+    )
+    descriptor.write_text(block, encoding="utf-8")
+    assert manifest_problems(descriptor) == []
+
+
+def test_an_english_manifest_is_answered_in_its_own_spelling(tmp_path):
+    project_dir = tmp_path / "repo" / "acme" / "crm"
+    project_dir.mkdir(parents=True)
+    descriptor = project_dir / "Project.yaml"
+    descriptor.write_text("Name: crm\nVendor: acme\nVersion: 1.0\n", encoding="utf-8")
+
+    problems = manifest_problems(descriptor)
+
+    assert '"Presentation: crm"' in problems[0]
+    assert '"DevelopmentLanguage: English"' in problems[1]
+
+    descriptor.write_text(
+        "Name: crm\nVendor: acme\nVersion: 1.0\nPresentation: CRM\nDevelopmentLanguage: English\n",
+        encoding="utf-8",
+    )
+    assert manifest_problems(descriptor) == []