lighthouse-cli 0.16.0__py3-none-any.whl

lighthouse/i18n.py

@@ -0,0 +1,250 @@
+# Copyright 2026 Atlantic Agentic Labs. All Rights Reserved.
+# SPDX-License-Identifier: Apache-2.0
+"""The CLI's language: what a person reads, in the language they chose.
+
+**Which language.** The first of these that names a supported one:
+
+1. `--lang <tag>` on the command line;
+2. `LIGHTHOUSE_LANG` in the environment;
+3. the signed-in person's effective setting (contract 1.29: their own, else
+   their organisation's), which `lighthouse whoami` and `lighthouse language`
+   keep in `language.json` beside the profile file, per host, so that no
+   command needs a request just to know how to print `--help`;
+4. `LC_ALL`, `LC_MESSAGES` or `LANG` (`fr_FR.UTF-8` is `fr`);
+5. `en`, British English, the source of every text.
+
+**What is translated**: help, prompts, errors, table headers and labels, the
+chrome around output. **What never is**: `--json` output (every key and every
+value the service sent), option names, exit codes, the `error` code in an error
+document, command names, and the product names LightHouse and Octy.
+
+Catalogues are JSON, one per tag, in `lighthouse/locales/`: flat, dotted keys,
+`{placeholders}` that every language keeps. `en.json` is the source; the others
+are machine-drafted and pending native review. A key a language lacks falls
+back to English, then to the key itself, so a missing translation never breaks
+a command. `service/scripts/i18n_lint.py` and `tests/test_i18n.py` hold every
+catalogue to `en`'s keys and placeholders, and every `t("key")` in the code to
+a key `en` has.
+
+The language is process-wide state set once per run by `main()` (`use`), so a
+command, the argument parser, `Out` and an error built deep inside the HTTP
+client all speak the same one without it being threaded through.
+"""
+from __future__ import annotations
+
+import argparse
+import json
+import re
+from collections.abc import Mapping
+from functools import cache
+from pathlib import Path
+from typing import Any
+
+FALLBACK = "en"
+# The same list as the service's (aal_control/languages.py); a test holds the two equal.
+TAGS = ("en", "fr", "de", "es", "it", "pt", "nl", "ga", "ja", "zh-Hans", "zh-Hant", "ar")
+ENV_LANG = "LIGHTHOUSE_LANG"
+LOCALES = Path(__file__).parent / "locales"
+CACHE_FILE = "language.json"
+_PLACEHOLDER = re.compile(r"\{([a-z_][a-z0-9_]*)\}")
+
+_current = FALLBACK
+
+
+@cache
+def catalogue(tag: str) -> Mapping[str, str]:
+    path = LOCALES / f"{tag}.json"
+    if tag not in TAGS or not path.is_file():
+        return {}
+    data = json.loads(path.read_text(encoding="utf-8"))
+    return {k: v for k, v in data.items() if isinstance(v, str) and not k.startswith("_")}
+
+
+def normalise(value: Any) -> str | None:
+    """A supported tag for what a person or the environment says, or None:
+    the tag itself, or its primary subtag (`fr-CA`, `de_DE.UTF-8`, `ga_IE@euro`).
+    Chinese keeps its script: `zh-Hant`, or a Taiwan, Hong Kong or Macao region
+    (`zh_TW.UTF-8`), is `zh-Hant`; any other `zh` (`zh`, `zh-CN`, `zh_SG`,
+    `zh-Hans-CN`) is `zh-Hans`. Case is ignored."""
+    if not isinstance(value, str):
+        return None
+    parts = [p for p in re.split(r"[-_.@]", value.strip().lower()) if p]
+    if not parts:
+        return None
+    if parts[0] == "zh":
+        # Only the subtags before the encoding or modifier (`.UTF-8`, `@euro`) count.
+        subtags = re.split(r"[.@]", value.strip().lower())[0].replace("_", "-").split("-")[1:]
+        rest = set(subtags)
+        if "hant" in rest or ("hans" not in rest and rest & {"tw", "hk", "mo"}):
+            return "zh-Hant"
+        return "zh-Hans"
+    return parts[0] if parts[0] in TAGS else None
+
+
+def current() -> str:
+    return _current
+
+
+def use(tag: str | None) -> str:
+    """Speak `tag` from now on (English when it is none of ours)."""
+    global _current
+    _current = tag if tag in TAGS else FALLBACK
+    return _current
+
+
+def t(key: str, **values: Any) -> str:
+    """The text for `key` in the current language; English, then the key."""
+    text = catalogue(_current).get(key)
+    if text is None:
+        text = catalogue(FALLBACK).get(key, key)
+    return _PLACEHOLDER.sub(lambda m: str(values.get(m.group(1), m.group(0))), text)
+
+
+def slug(text: str) -> str:
+    return re.sub(r"[^a-z0-9]+", "_", text.lower()).strip("_")
+
+
+def label(text: str) -> str:
+    """A table header or a label of a pair in the current language, when the
+    catalogue has one for this English text; as given otherwise (a column
+    named after a group-by, a value from the service)."""
+    key = f"label.{slug(text)}"
+    return t(key) if key in catalogue(_current) else text
+
+
+def yes_answers() -> tuple[str, ...]:
+    return tuple(a.strip().lower() for a in t("confirm.yes").split(",") if a.strip())
+
+
+# -- which language ---------------------------------------------------------------------
+
+def cache_path(config_dir: Path) -> Path:
+    return config_dir / CACHE_FILE
+
+
+def remembered(config_dir: Path, host: str | None) -> str | None:
+    """The viewer's effective language last seen for `host`, if any."""
+    if not host:
+        return None
+    try:
+        data = json.loads(cache_path(config_dir).read_text(encoding="utf-8"))
+    except (OSError, ValueError):
+        return None
+    return normalise(data.get(host)) if isinstance(data, dict) else None
+
+
+def remember(config_dir: Path, host: str, tag: str | None) -> None:
+    """Keep (or, for a person with none set, forget) the effective language
+    for `host`. Best effort: a cache that cannot be written costs nothing."""
+    path = cache_path(config_dir)
+    try:
+        data = json.loads(path.read_text(encoding="utf-8"))
+        data = data if isinstance(data, dict) else {}
+    except (OSError, ValueError):
+        data = {}
+    if tag in TAGS:
+        data[host] = tag
+    else:
+        data.pop(host, None)
+    try:
+        path.parent.mkdir(parents=True, exist_ok=True)
+        path.write_text(json.dumps(data, sort_keys=True) + "\n", encoding="utf-8")
+        path.chmod(0o600)
+    except OSError:
+        return
+
+
+def from_environment(env: Mapping[str, str]) -> str | None:
+    for name in ("LC_ALL", "LC_MESSAGES", "LANG"):
+        tag = normalise(env.get(name))
+        if tag:
+            return tag
+    return None
+
+
+def flag_in(argv: list[str]) -> str | None:
+    """`--lang` read off the raw command line, before the parser exists (the
+    parser's own help has to be in the language). The first occurrence wins."""
+    for i, arg in enumerate(argv):
+        if arg == "--lang" and i + 1 < len(argv):
+            return argv[i + 1]
+        if arg.startswith("--lang="):
+            return arg.split("=", 1)[1]
+    return None
+
+
+def choose(argv: list[str], env: Mapping[str, str], config_dir: Path | None = None,
+           host: str | None = None) -> str:
+    """The run's language, by the order in the module docstring. An
+    unsupported `--lang` or `LIGHTHOUSE_LANG` is skipped here (and refused
+    by `main` for the flag); it never leaves the CLI mute."""
+    for given in (flag_in(argv), env.get(ENV_LANG)):
+        tag = normalise(given) if given else None
+        if tag:
+            return tag
+    if config_dir is not None:
+        tag = remembered(config_dir, host)
+        if tag:
+            return tag
+    return from_environment(env) or FALLBACK
+
+
+# -- the argument parser -----------------------------------------------------------------
+
+def help_key(path: list[str], dest: str) -> str:
+    return ".".join(["help", *path, dest])
+
+
+def help_strings(root: argparse.ArgumentParser) -> dict[str, str]:
+    """Every help text of the parser tree by catalogue key (`help.<command>...`):
+    what `localise` replaces and what `tests/test_i18n.py` holds `en.json` to."""
+    found: dict[str, str] = {}
+
+    def walk(p: argparse.ArgumentParser, path: list[str]) -> None:
+        for a in p._actions:  # noqa: SLF001 - argparse has no public walk
+            if isinstance(a, argparse._SubParsersAction):  # noqa: SLF001
+                for choice in a._choices_actions:  # noqa: SLF001
+                    if choice.help:
+                        found[help_key([*path, choice.dest], "_help")] = choice.help
+                for name, sub in a.choices.items():
+                    own = found.get(help_key([*path, name], "_help"))
+                    if sub.description and sub.description != own:
+                        found[help_key([*path, name], "_description")] = sub.description
+                    walk(sub, [*path, name])
+            elif (a.help and a.help != argparse.SUPPRESS
+                  and not isinstance(a, (argparse._HelpAction, argparse._VersionAction))):  # noqa: SLF001
+                found[help_key(path, a.dest)] = a.help
+
+    walk(root, [])
+    return found
+
+
+def localise(root: argparse.ArgumentParser) -> argparse.ArgumentParser:
+    """Put the current language's help into the parser tree. English is the
+    parser's own text, so English changes nothing."""
+    if _current == FALLBACK:
+        return root
+    cat = catalogue(_current)
+
+    def walk(p: argparse.ArgumentParser, path: list[str]) -> None:
+        for a in p._actions:  # noqa: SLF001
+            if isinstance(a, argparse._SubParsersAction):  # noqa: SLF001
+                for choice in a._choices_actions:  # noqa: SLF001
+                    key = help_key([*path, choice.dest], "_help")
+                    if key in cat:
+                        choice.help = cat[key]
+                for name, sub in a.choices.items():
+                    own = help_key([*path, name], "_help")
+                    desc = help_key([*path, name], "_description")
+                    if desc in cat:
+                        sub.description = cat[desc]
+                    elif own in cat:
+                        sub.description = cat[own]
+                    walk(sub, [*path, name])
+            elif a.help and a.help != argparse.SUPPRESS:
+                key = help_key(path, a.dest)
+                if key in cat:
+                    a.help = cat[key]
+
+    walk(root, [])
+    return root

lighthouse/locales/ar.json

@@ -0,0 +1,343 @@
+{
+ "_comment": "ar: machine-drafted, pending native review.",
+ "main.description": "LightHouse™ من سطر الأوامر: سجّل الدخول، واربط منظومتك، وانشر الوكلاء، وراقب التشغيلات، واطّلع على التكلفة.",
+ "main.epilog": "رموز الخروج: 0 نجاح، 1 فشل، 2 خطأ في الاستخدام، 3 لم يتم تسجيل الدخول، 4 ممنوع، 5 أعد المحاولة لاحقاً، 7 يتطلب شخصاً. LightHouse وOcty علامتان تجاريتان لشركة Atlantic Agentic Labs. المستندات: https://docs.atlanticagenticlabs.com/cli/",
+ "out.error": "خطأ",
+ "out.warning": "تحذير",
+ "out.nothing": "(لا شيء)",
+ "confirm.suffix": "[y/N]",
+ "confirm.yes": "y,yes,نعم",
+ "note.stopped": "متوقف",
+ "note.waiting_for_approval": "بانتظار الموافقة…",
+ "prompt.open_browser": "اضغط Enter لفتح المتصفح، أو Ctrl-C للإيقاف…",
+ "prompt.revoke_token": "هل تريد إلغاء الرمز {token}؟",
+ "err.not_signed_in": "لم يتم تسجيل الدخول",
+ "err.not_signed_in_for": "لم يتم تسجيل الدخول إلى {host}",
+ "hint.login": "شغّل `lighthouse login`",
+ "hint.login_again": "شغّل `lighthouse login` مرة أخرى",
+ "err.needs_a_person": "{what} يتطلب شخصاً أمام لوحة المفاتيح",
+ "hint.needs_a_person": "شغّله دون --no-input، أو حدّد القيمة في سطر الأوامر",
+ "err.no_host": "لم يتم تحديد مضيف المؤسسة",
+ "hint.no_host": "مرّر --host <tenant-id>.atlanticagenticlabs.com، أو عيّن LIGHTHOUSE_HOST، أو شغّل `lighthouse login --host …` مرة واحدة",
+ "err.bad_host": "{given} ليس اسم مضيف",
+ "hint.bad_host": "استخدم معرّف المؤسسة، أو اسم مضيف البوابة",
+ "err.bad_config": "تعذّرت قراءة {path}: {error}",
+ "hint.bad_config": "أصلحه، أو احذفه وشغّل `lighthouse login` مرة أخرى",
+ "err.pairing_expired": "انتهت صلاحية رمز الإقران قبل الموافقة عليه",
+ "err.sign_in_declined": "رُفض تسجيل الدخول في البوابة",
+ "err.no_terminal": "لا توجد طرفية للسؤال عليها",
+ "hint.no_terminal": "مرّر --yes لفتح المتصفح، أو --no-browser",
+ "err.timeout": "انتهت مهلة {method} {path}",
+ "err.unreachable": "تعذّر الوصول إلى {host}: {error}",
+ "hint.unreachable": "تحقق من اسم المضيف ومن شبكتك",
+ "err.not_json": "{method} {path}: أجابت الخدمة بما ليس JSON",
+ "err.exhausted": "لم ينجح {method} {path}",
+ "err.service_answered": "أجابت الخدمة بالحالة {status}",
+ "hint.scope_required": "سجّل الدخول مجدداً بالنطاق الذي يتطلبه هذا، مثلاً `lighthouse login --scope \"telemetry:read agents:read {scope}\"`",
+ "err.access_state_wrong": "خاطئ أو لا يملك صلاحية الوصول إلى هذه المؤسسة",
+ "err.access_state_missing": "مفقود",
+ "err.access_stopped": "أوقف Cloudflare Access الطلب قبل وصوله إلى LightHouse: رمز خدمة Access {state}",
+ "hint.access_stopped": "عيّن {id} و{secret} إلى رمز خدمة Access الخاص بالمؤسسة (أو مرّر --access-client-id إلى `lighthouse login`)",
+ "err.machine_key_refused": "رُفض مفتاح الآلة في {env}: ربما أُلغي، أو يعود إلى مؤسسة أخرى",
+ "hint.machine_key_refused": "تحقق من صفحة المفاتيح في البوابة؛ مفتاح الآلة لا يُجدَّد ولا تنتهي صلاحيته بالوقت",
+ "err.delegated_token_refused": "انتهت صلاحية الرمز المفوَّض في {env} أو أُلغي. الرمز المفوَّض (lhat-...) يدوم ثماني ساعات ولا يُجدَّد في خط الإنتاج (pipeline)",
+ "hint.delegated_token_refused": "للتكامل المستمر (CI)، أنشئ مفتاح آلة (aalcp-...) من صفحة المفاتيح في البوابة وضعه في {env}، مع رمز خدمة Access الخاص بالمؤسسة",
+ "err.access_token_incomplete": "رمز خدمة Cloudflare Access معيَّن جزئياً: {missing} مفقود",
+ "hint.access_token_incomplete": "عيّن كلاً من {id} و{secret}",
+ "err.access_secret_empty": "تم تمرير --access-client-secret-stdin لكن الإدخال القياسي كان فارغاً",
+ "err.access_id_missing": "قُرئ سر Access لكن لا يوجد معرّف يقابله",
+ "hint.access_id_missing": "مرّر --access-client-id أو عيّن {id}",
+ "err.access_secret_missing": "--access-client-id يتطلب سرّه",
+ "hint.access_secret_missing": "مرّره إلى --access-client-secret-stdin، أو عيّن {secret}. لا يكون وسيطاً في سطر الأوامر أبداً",
+ "err.machine_key_no_tokens": "مفتاح الآلة ليس له رموز مفوَّضة لعرضها أو إلغائها",
+ "hint.machine_key_no_tokens": "ألغِ مفتاح الآلة من صفحة المفاتيح في البوابة؛ `lighthouse tokens` مخصص للرموز المفوَّضة التي يسجّل بها الأشخاص دخولهم",
+ "err.not_revoked": "لم يُلغَ",
+ "err.no_tokens_to_list": "ليس لبيانات الاعتماد هذه رموز مفوَّضة لعرضها",
+ "err.unsupported_language": "{lang} ليست لغة مدعومة",
+ "hint.unsupported_language": "استخدم إحدى: {tags}",
+ "err.language_both": "حدّد لغة أو --clear، وليس كليهما",
+ "login.pairing_code": "رمز الإقران الخاص بك: {code}",
+ "login.approve_at": "وافق عليه في {url}",
+ "login.asking_for": "طلب: {scope}",
+ "login.signed_in": "تم تسجيل الدخول إلى {tenant} بصفة {email} ({role}).",
+ "login.scopes": "النطاقات: {scopes}",
+ "login.no_scopes": "(لا شيء)",
+ "login.in_keychain": "الرمز محفوظ في سلسلة مفاتيح نظام التشغيل لديك، وليس في أي ملف",
+ "login.access_kept": "ورمز خدمة Cloudflare Access محفوظ هناك معه",
+ "logout.nothing_stored": "{host}: لا شيء مخزّن",
+ "logout.revoked": "{host}: أُلغي ونُسي",
+ "logout.forgotten": "{host}: نُسي هنا؛ وتنتهي صلاحيته في الخدمة من تلقاء نفسها",
+ "logout.could_not_revoke": "{host}: تعذّر الإلغاء في الخدمة ({error})؛ سيُنسى هنا على أي حال",
+ "tokens.revoked": "أُلغي {token}",
+ "whoami.all_reach": "(كل ما يصل إليه هذا الدور)",
+ "whoami.machine_key": "مفتاح آلة",
+ "whoami.delegated_token": "رمز مفوَّض",
+ "whoami.never_by_time": "لا ينتهي بالوقت أبداً",
+ "whoami.note_machine_key": "مفتاح الآلة لا يُجدَّد أبداً ولا تنتهي صلاحيته بالوقت؛ ألغِه من صفحة المفاتيح في البوابة",
+ "whoami.note_delegated_token": "الرمز المفوَّض تنتهي صلاحيته بعد ثماني ساعات ولا يُجدَّد مع LIGHTHOUSE_TOKEN؛ للتكامل المستمر (CI) استخدم مفتاح آلة (aalcp-...) من صفحة المفاتيح في البوابة",
+ "help.host": "اسم مضيف المؤسسة أو معرّفها",
+ "help.as_json": "مستند JSON واحد على الإخراج القياسي، ولا شيء غيره",
+ "help.quiet": "بلا نص",
+ "help.no_input": "لا تسأل أي شخص أي شيء؛ اخرج بالرمز 7 بدلاً من ذلك",
+ "help.yes": "أجب بنعم على كل تأكيد",
+ "help.timeout": "ثوانٍ لطلب واحد",
+ "help.lang": "اللغة المستخدمة: en أو fr أو de أو es أو it أو pt أو nl, ga, ja, zh-Hans, zh-Hant, ar (الافتراضي: إعدادك، ثم LANG)",
+ "help.login._help": "سجّل الدخول عبر المتصفح برمز جهاز",
+ "help.logout._help": "ألغِ رمز هذا الجهاز وانسَه",
+ "help.tokens._help": "رموزك المفوَّضة، وإلغاء أحدها",
+ "help.whoami._help": "من سُجّل دخوله في واجهة سطر الأوامر هذه، وبأي صلاحيات",
+ "help.connect._help": "افتح موافقة المزوّد نفسه لهذه المؤسسة",
+ "help.connections._help": "جداول مزامنة اتصالاتك، وضبط أحدها، أو المزامنة الآن",
+ "help.collectors._help": "اطلب من Atlantic مُجمِّعاً، وتابع طلباتك",
+ "help.models._help": "مكتبة النماذج ودرجات أدلتها",
+ "help.kb._help": "قواعد المعرفة وحداثتها والاستيعاب فيها",
+ "help.agents._help": "اعرض الوكلاء وافحصهم وأنشئ هياكلهم وانشرهم وتراجع عنهم",
+ "help.builds._help": "الوكلاء المبنيون بمنشئ الوكلاء، ومكان كل منهم",
+ "help.evals._help": "نتائج التقييم، وتشغيل مجموعة",
+ "help.runs._help": "ما يعمل الآن، وما عمل",
+ "help.spend._help": "ما أُنفق، وإلى أين يتجه، وما وُفّر",
+ "help.limits._help": "حدود الإنفاق السارية، وهل طبّقتها المحركات",
+ "help.terms._help": "الشروط التجارية السارية لهذه المؤسسة",
+ "help.stack._help": "احصل على حزمتي: الملفات التي تشغّل LightHouse حيث اخترت",
+ "help.language._help": "لغتك، واللغات المتاحة",
+ "help.login.scope": "النطاقات المطلوبة، مفصولة بمسافة (الافتراضي: telemetry:read agents:read)",
+ "help.login.no_browser": "اطبع الرابط بدلاً من فتح متصفح",
+ "help.login.name": "كيف يُوصَف تسجيل الدخول هذا في البوابة وسجل التدقيق",
+ "help.login.access_client_id": "معرّف رمز خدمة Cloudflare Access الخاص بالمؤسسة، ليُحفظ مع تسجيل الدخول (السر: --access-client-secret-stdin)",
+ "help.login.access_secret_stdin": "اقرأ سر رمز خدمة Access من سطر واحد من الإدخال القياسي",
+ "help.logout.every": "انسَ كل مضيف، لا المضيف الحالي فقط",
+ "help.tokens.revoke": "ألغِ أحد رموزك بمعرّفه",
+ "help.whoami.profiles": "اعرض أيضاً كل مضيف سُجّل الدخول إليه على هذا الجهاز",
+ "help.connect.provider": "المزوّد المراد الاتصال به؛ `list` (أو لا شيء) لعرضهم",
+ "help.connect.family": "مع list: عائلة واحدة (google، microsoft، oracle، crm، ...)",
+ "help.connect.kind": "مع list: ما يحتويه (crm، mail، service-desk، ...)",
+ "help.connect.search": "مع list: كلمات للبحث عنها في الاسم أو العائلة أو النوع أو الوصف (\"email\" تجد Mail، و\"tickets\" تجد Service desk)",
+ "help.connect.state": "مع list: الموصّلات في هذه الحالة فقط",
+ "help.connect.no_browser": "اطبع رابط الموافقة بدلاً من فتحه",
+ "help.connect.reuse_local": "اعرض إعادة استخدام تسجيل دخول موجود على هذا الجهاز (يسأل أولاً)",
+ "help.connect.every": "بلا مزوّد: اعرض القادمة أيضاً",
+ "help.connect.credential_stdin": "اربط رمزاً موجوداً، يُقرأ من الإدخال القياسي، بصفتك (يتطلب `cloudflared access login https://<host>`)",
+ "help.connect.access": "مع --credential-stdin: read (الافتراضي) أو read_write",
+ "help.connect.target": "مع --credential-stdin: ما يشير إليه الاتصال (organisation=..., instance_url=..., site=...)؛ قابل للتكرار",
+ "help.connect.deployment": "مع --credential-stdin: عملية النشر التي تحتفظ ببيانات الاعتماد، حيث يكون للمؤسسة أكثر من واحدة",
+ "help.connect.deployment_key": "مع --credential-stdin: ثبّت المفتاح العام لعملية النشر (base64 أو PEM، كما طبعته بنيتك التحتية)؛ يُختم الرمز فقط لمفتاح ختم وقّعه ذلك المفتاح (أو LIGHTHOUSE_DEPLOYMENT_KEY)",
+ "help.connections.list._help": "كل اتصال وجدول مزامنته والمزامنة التالية (الافتراضي)",
+ "help.connections.schedule._help": "اضبط وتيرة مزامنة اتصال (client_admin، بصفتك)",
+ "help.connections.sync._help": "زامن اتصالاً الآن (client_admin، بصفتك)",
+ "help.connections.schedule.connection": "معرّف الاتصال، cx-...",
+ "help.connections.schedule.mode": "off أو every_15m أو hourly أو working_hours أو daily",
+ "help.connections.schedule.at": "مع --mode daily: الوقت بصيغة 24 ساعة HH:MM",
+ "help.connections.schedule.tz": "مع working_hours أو daily: المنطقة الزمنية، مثل Europe/London",
+ "help.connections.schedule.card": "المصدر، <pack>:<card>، حيث تبلغ عملية النشر عن أكثر من واحد",
+ "help.connections.schedule.deployment": "عملية النشر، حيث يعمل المصدر في أكثر من واحدة",
+ "help.connections.schedule.reason": "السبب، لسجل التدقيق",
+ "help.connections.sync.connection": "معرّف الاتصال، cx-...",
+ "help.connections.sync.card": "المصدر، <pack>:<card>، حيث تبلغ عملية النشر عن أكثر من واحد",
+ "help.connections.sync.deployment": "عملية النشر، حيث يعمل المصدر في أكثر من واحدة",
+ "help.connections.sync.reason": "السبب، لسجل التدقيق",
+ "help.collectors.requests._help": "طلبات المُجمِّعات الخاصة بمؤسستك ومرحلة كل منها (الافتراضي)",
+ "help.collectors.request._help": "اطلب من Atlantic مُجمِّعاً (handler أو client_admin)",
+ "help.collectors.request.vendor": "من يصنع النظام، مثل 'Invented CRM'",
+ "help.collectors.request.product": "المنتج، مثل 'Sales Suite'",
+ "help.collectors.request.reads": "ما ينبغي أن يقرأه",
+ "help.collectors.request.cloud": "أين تعمل عملية النشر لديك",
+ "help.collectors.request.kind": "ما يقرأه، كمعرّف نصي (slug): crm، tickets، wiki، ...",
+ "help.collectors.request.access": "read (الافتراضي) أو read_write",
+ "help.collectors.request.urgency": "low أو normal (الافتراضي) أو high",
+ "help.collectors.request.docs_url": "وثائق API العامة للمورّد، https://",
+ "help.models.task": "مقبول للتوافق؛ لا ترتّب الخدمة المكتبة حسب المهمة، لذا لا يغيّر شيئاً",
+ "help.models.provider": "نماذج هذا المزوّد فقط",
+ "help.kb.list._help": "كل قاعدة معرفة (الافتراضي)",
+ "help.kb.show._help": "قاعدة معرفة واحدة",
+ "help.kb.ingest._help": "زامن اتصالاً في قاعدة معرفة الآن (بصفتك)",
+ "help.kb.upload._help": "ارفع ملفاً مباشرة إلى المخزن الخاص بعملية النشر لديك",
+ "help.kb.show.index": "اسم الفهرس",
+ "help.kb.ingest.source": "معرّف اتصال (cx-...) أو موصّل: github، gitlab، confluence، jira، gdrive…",
+ "help.kb.ingest.repo": "ضيّق موصّلاً إلى اتصال واحد بتسميته أو هدفه، مثل owner/name",
+ "help.kb.ingest.reason": "السبب، لسجل التدقيق",
+ "help.kb.ingest.wait": "انتظر حتى تنتهي المزامنة",
+ "help.kb.ingest.wait_timeout": "أقصى عدد من الثواني للانتظار (الافتراضي 1800)؛ ثم الخروج بالرمز 5",
+ "help.kb.upload.file": "الملف: .md، .txt، .csv، .pdf، .docx، .pptx، .xlsx…",
+ "help.kb.upload.deployment": "أي عملية نشر، حيث يكون لديك أكثر من واحدة",
+ "help.agents.list._help": "كل وكيل (الافتراضي)",
+ "help.agents.show._help": "إعدادات وكيل واحد وآخر تشغيلاته",
+ "help.agents.init._help": "أنشئ هيكل agent.toml في هذا الدليل",
+ "help.agents.logs._help": "تشغيلات وكيل، وخطوات تشغيل واحد",
+ "help.agents.deploy._help": "اجعل إصداراً منشوراً من وكيل هو الحالي (نطاق deploy)",
+ "help.agents.rollback._help": "ارجع إلى إصدار منشور سابق (نطاق deploy)",
+ "help.agents.show.agent": "pack:card، مثل research:summary",
+ "help.agents.init.name": "اسم الوكيل",
+ "help.agents.init.file": "مكان كتابته",
+ "help.agents.init.force": "استبدل ملفاً موجوداً",
+ "help.agents.logs.status": "التشغيلات بهذه الحالة فقط",
+ "help.agents.logs.trace": "امتدادات تشغيل واحد بدلاً من ذلك",
+ "help.agents.deploy.agent": "pack:card، مثل research:summary",
+ "help.agents.deploy.version": "الإصدار المنشور المراد جعله الحالي",
+ "help.agents.deploy.deployment": "عملية النشر، حيث يكون للمؤسسة أكثر من واحدة",
+ "help.agents.deploy.reason": "السبب، لسجل التدقيق",
+ "help.agents.deploy.wait": "انتظر حتى ترد عملية النشر (وإن كانت تنتظر الموافقة، فحتى صدور القرار)",
+ "help.agents.deploy.wait_timeout": "أقصى عدد من الثواني للانتظار (الافتراضي 900)؛ ثم الخروج بالرمز 5",
+ "help.agents.rollback.agent": "pack:card",
+ "help.agents.rollback.to": "الإصدار المراد الرجوع إليه (الافتراضي: آخر إصدار اجتاز بوابته قبل الحالي)",
+ "help.agents.rollback.deployment": "عملية النشر، حيث يكون للمؤسسة أكثر من واحدة",
+ "help.agents.rollback.reason": "السبب، لسجل التدقيق",
+ "help.agents.rollback.wait": "انتظر حتى ترد عملية النشر (وإن كانت تنتظر الموافقة، فحتى صدور القرار)",
+ "help.agents.rollback.wait_timeout": "أقصى عدد من الثواني للانتظار (الافتراضي 900)؛ ثم الخروج بالرمز 5",
+ "help.builds.status": "المقترحات في هذه الخطوة فقط، مثل publish_requested",
+ "help.builds.show._help": "مقترح واحد، مع درجاته وتكلفته التقديرية",
+ "help.builds.show.proposal": "معرّف المقترح (32 حرفاً سداسياً عشرياً)",
+ "help.evals.list._help": "أحدث النتائج (الافتراضي)",
+ "help.evals.run._help": "شغّل تقييم وكيل مرة واحدة، ضمن حدّ إنفاق",
+ "help.evals.list.fail_below": "اخرج بالرمز 1 إذا كان مقياس أي صف أدنى من هذا، أو لا يملك هذا المقياس",
+ "help.evals.list.metric": "المقياس الذي يقرؤه --fail-below من `metrics` لكل صف (الافتراضي: f1)",
+ "help.evals.run.agent": "pack:card، مثل research:summary",
+ "help.evals.run.cap": "أقصى ما يجوز لهذا التشغيل إنفاقه، بالدولار الأمريكي",
+ "help.evals.run.eval_set": "مجموعة تقييم واحدة (معرّف بطاقة التقييم الخاصة بها)",
+ "help.evals.run.deployment": "عملية النشر، حيث يكون للمؤسسة أكثر من واحدة",
+ "help.evals.run.reason": "السبب، لسجل التدقيق",
+ "help.evals.run.wait": "انتظر نتائج التقييم، واجعلها بوابة",
+ "help.evals.run.wait_timeout": "أقصى عدد من الثواني للانتظار (الافتراضي 1800)؛ ثم الخروج بالرمز 5",
+ "help.evals.run.fail_below": "مع --wait: اخرج بالرمز 1 إذا كان مقياس صف جديد أدنى من هذا، أو مفقوداً",
+ "help.evals.run.metric": "المقياس الذي يقرؤه --fail-below (الافتراضي: f1)",
+ "help.runs.list._help": "آخر التشغيلات (الافتراضي)",
+ "help.runs.show._help": "تشغيل واحد",
+ "help.runs.tail._help": "تابع التشغيلات الحية",
+ "help.runs.show.run": "قيمة run_id_hash الخاصة به",
+ "help.runs.show.as_map": "خريطة التشغيل: كل خطوة واستدعاء نموذج واسترجاع",
+ "help.runs.tail.interval": "ثوانٍ بين كل استطلاع",
+ "help.runs.tail.once": "لقطة واحدة، ثم توقف",
+ "help.runs.tail.duration": "توقف بعد هذا العدد من الثواني",
+ "help.runs.tail.deployment": "تشغيلات عملية النشر هذه فقط",
+ "help.runs.tail.fail_on_stall": "اخرج بالرمز 1 إذا تعثّر تشغيل",
+ "help.spend.by": "كيفية التجميع",
+ "help.spend.month": "YYYY-MM؛ الشهر الحالي افتراضياً",
+ "help.spend.forecast": "وإسقاط نهاية الشهر مقابل الحدّ الأقصى أيضاً",
+ "help.spend.savings": "ورقم الوفورات التقديري الرئيسي أيضاً",
+ "help.limits.scope": "حدود هذا النوع من النطاق فقط",
+ "help.terms.term": "شرط واحد بمفتاحه",
+ "help.stack.cloud": "aws أو azure أو gcp أو onprem (الافتراضي: المختارة)",
+ "help.stack.region": "المنطقة (الافتراضي: المختارة)",
+ "help.stack.profile": "always_on أو ephemeral (الافتراضي: المختار)",
+ "help.stack.deployment": "أي عمليات النشر النشطة لديك تخصها الملفات",
+ "help.stack.out": "اكتب كل ملف في هذا الدليل",
+ "help.stack.force": "استبدل الملفات التي تسمّيها الحزمة وتكون موجودة هناك",
+ "help.language.list_all": "اعرض اللغات المتاحة فقط",
+ "label.agent": "الوكيل",
+ "label.pack": "الحزمة",
+ "label.state": "الحالة",
+ "label.models": "النماذج",
+ "label.runs_month": "التشغيلات (الشهر)",
+ "label.estimated_cost": "التكلفة التقديرية",
+ "label.version": "الإصدار",
+ "label.status": "الحالة",
+ "label.command": "الأمر",
+ "label.span": "الامتداد",
+ "label.kind": "النوع",
+ "label.starts_at_ms": "يبدأ عند (مللي ثانية)",
+ "label.took_ms": "استغرق (مللي ثانية)",
+ "label.run": "التشغيل",
+ "label.started": "بدأ",
+ "label.attempts": "المحاولات",
+ "label.trigger": "المشغّل",
+ "label.proposal": "المقترح",
+ "label.evaluation": "التقييم",
+ "label.estimated_month": "تقديري / شهر",
+ "label.deployment": "النشر",
+ "label.template": "القالب",
+ "label.problems": "المشكلات",
+ "label.retrieval": "الاسترجاع",
+ "label.estimated_per_run": "تقديري لكل تشغيل",
+ "label.estimated_per_month": "تقديري لكل شهر",
+ "label.request": "الطلب",
+ "label.collector": "المُجمِّع",
+ "label.stage": "المرحلة",
+ "label.issue": "المسألة",
+ "label.clients_asking": "العملاء الطالبون",
+ "label.asked": "طُلب",
+ "label.provider": "المزوّد",
+ "label.what": "ماذا",
+ "label.family": "العائلة",
+ "label.read_only_scopes": "نطاقات القراءة فقط",
+ "label.approve_at": "الموافقة في",
+ "label.sent_to_your_own_store": "أُرسل إلى مخزنك",
+ "label.access": "الوصول",
+ "label.connection": "الاتصال",
+ "label.connected": "متصل",
+ "label.syncing": "يزامن",
+ "label.last_sync": "آخر مزامنة",
+ "label.connector": "الموصّل",
+ "label.schedule": "الجدول",
+ "label.next_sync": "المزامنة التالية",
+ "label.asked_for": "المطلوب",
+ "label.suite": "المجموعة",
+ "label.passed": "اجتاز",
+ "label.metrics": "المقاييس",
+ "label.measured": "قيس",
+ "label.cap": "الحدّ الأقصى",
+ "label.index": "الفهرس",
+ "label.documents": "المستندات",
+ "label.chunks": "المقاطع",
+ "label.last_refreshed": "آخر تحديث",
+ "label.health": "الصحة",
+ "label.backend": "الواجهة الخلفية",
+ "label.knowledge_base": "قاعدة المعرفة",
+ "label.uploaded": "رُفع",
+ "label.bytes": "بايتات",
+ "label.indexed": "فُهرس",
+ "label.tag": "الوسم",
+ "label.language": "اللغة",
+ "label.your_language": "لغتك",
+ "label.your_organisation_s": "لغة مؤسستك",
+ "label.in_use_now": "قيد الاستخدام",
+ "label.scope": "النطاق",
+ "label.period": "الفترة",
+ "label.spent": "المنفَق",
+ "label.used": "المستخدم %",
+ "label.alerts_at": "التنبيه عند %",
+ "label.applied_by": "طُبّق بواسطة",
+ "label.token": "الرمز",
+ "label.client": "العميل",
+ "label.scopes": "النطاقات",
+ "label.issued": "صدر",
+ "label.expires": "ينتهي",
+ "label.last_used": "آخر استخدام",
+ "label.step": "الخطوة",
+ "label.tokens_in_out": "الرموز داخل/خارج",
+ "label.elapsed": "المنقضي",
+ "label.calls": "الاستدعاءات",
+ "label.input_tokens": "رموز الإدخال",
+ "label.output_tokens": "رموز الإخراج",
+ "label.cost_usd": "التكلفة (USD)",
+ "label.managed_charge": "الرسوم المُدارة",
+ "label.month": "الشهر",
+ "label.total_cost_usd": "إجمالي التكلفة (USD)",
+ "label.shown_in": "معروض بـ",
+ "label.projected_month_end_estimated": "المتوقع لنهاية الشهر (تقديري)",
+ "label.likely_range_estimated": "النطاق المرجّح (تقديري)",
+ "label.against_the_cap": "مقابل الحدّ الأقصى",
+ "label.estimated_saving_this_month": "الوفر التقديري هذا الشهر",
+ "label.in_words": "بالكلمات",
+ "label.where": "أين",
+ "label.profile": "الملف",
+ "label.infrastructure": "البنية التحتية",
+ "label.written_to": "كُتب في",
+ "label.file": "الملف",
+ "label.written": "كُتب",
+ "label.term": "الشرط",
+ "label.meaning": "المعنى",
+ "label.set_by": "حدّده",
+ "label.direction": "الاتجاه",
+ "label.in_force_from": "ساري من",
+ "label.tenant": "المؤسسة",
+ "label.host": "المضيف",
+ "label.person": "الشخص",
+ "label.role": "الدور",
+ "label.signed_in_with": "سُجّل الدخول بـ",
+ "label.credential_from": "مصدر بيانات الاعتماد",
+ "label.credential_kind": "نوع بيانات الاعتماد",
+ "label.model": "النموذج",
+ "label.evals": "التقييمات",
+ "label.calls_month": "الاستدعاءات (الشهر)",
+ "label.input_m": "الإدخال /M",
+ "label.output_m": "الإخراج /M"
+}