lighthouse-cli 0.16.0__py3-none-any.whl

lighthouse/locales/zh-Hant.json

@@ -0,0 +1,343 @@
+{
+ "_comment": "zh-Hant: 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": "請使用租用戶 id 或門戶的主機名",
+ "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": "請求在到達 LightHouse 之前被 Cloudflare Access 攔截：Access 服務權杖{state}",
+ "hint.access_stopped": "請將 {id} 和 {secret} 設定為該租用戶的 Access 服務權杖（或向 `lighthouse login` 傳入 --access-client-id）",
+ "err.machine_key_refused": "{env} 中的機器金鑰被拒絕：它可能已被撤銷，或屬於其他租用戶",
+ "hint.machine_key_refused": "請檢視門戶中的“金鑰”頁面；機器金鑰不會重新整理，也不會按時間過期",
+ "err.delegated_token_refused": "{env} 中的委派權杖已過期或已被撤銷。委派權杖（lhat-...）有效期為八小時，在流水線中不會重新整理",
+ "hint.delegated_token_refused": "對於 CI，請在門戶的“金鑰”頁面建立機器金鑰（aalcp-...），並將其與該租用戶的 Access 服務權杖一起放入 {env}",
+ "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 金鑰，但沒有與之配套的 id",
+ "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": "已以 {email}（{role}）身份登入 {tenant}。",
+ "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": "租用戶的主機名或 id",
+ "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": "此 CLI 以誰的身份登入，以及可訪問的範圍",
+ "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": "列印 URL，而不是開啟瀏覽器",
+ "help.login.name": "此次登入在門戶和審計日誌中的描述",
+ "help.login.access_client_id": "租用戶的 Cloudflare Access 服務權杖 id，隨登入一併儲存（金鑰：--access-client-secret-stdin）",
+ "help.login.access_secret_stdin": "從標準輸入的一行讀取 Access 服務權杖金鑰",
+ "help.logout.every": "清除所有主機，而不僅是目前主機",
+ "help.tokens.revoke": "按 id 撤銷你自己的一個權杖",
+ "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": "列印批准 URL，而不是開啟它",
+ "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": "連線的 id，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": "連線的 id，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": "連線 id（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": "改為顯示單次執行的 span",
+ "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": "提案的 id（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": "一個評估集（其評估卡片的 id）",
+ "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": "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": "成本（美元）",
+ "label.managed_charge": "託管費用",
+ "label.month": "月份",
+ "label.total_cost_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"
+}

lighthouse/main.py

@@ -0,0 +1,229 @@
+# Copyright 2026 Atlantic Agentic Labs. All Rights Reserved.
+# SPDX-License-Identifier: Apache-2.0
+"""`lighthouse`: the argument parser, the dispatcher and the exit code.
+
+Every command is a function in `lighthouse.commands`, registered in `COMMANDS`
+below with the subparser that configures it. Each one takes a `Context` and
+returns a JSON-serialisable document; `main` prints it under `--json` or lets
+the command's own `show` render it for a person. That split is why the golden
+test can assert on the whole of `--json` for every command at once: no command
+formats its own JSON.
+
+Global options, accepted before or after the subcommand:
+
+    --host HOST     the tenant (config.py explains how it is resolved)
+    --json          one JSON document on standard output, nothing else
+    --quiet         no prose; refusals still go to standard error
+    --no-input      never ask a person anything; exit 7 if it would have to
+    --yes           answer yes to every confirmation
+    --timeout N     seconds for one request (connect, read and write each)
+    --lang TAG      the language to speak (i18n.py: en, fr, de, es, it, pt, nl, ga, ja, zh-Hans, zh-Hant, ar)
+    --version
+
+`main(argv)` returns the exit code and prints nothing that is not asked for, so
+the tests drive it directly; `run()` is the console script and calls `sys.exit`.
+"""
+from __future__ import annotations
+
+import argparse
+import logging
+import os
+import sys
+from dataclasses import dataclass, field
+from collections.abc import Callable
+from pathlib import Path
+from typing import Any, TextIO
+
+from lighthouse import __version__, exits
+from lighthouse import flags, i18n
+from lighthouse.config import Config
+from lighthouse.credentials import Store
+from lighthouse.exits import CliError
+from lighthouse.http import Client
+from lighthouse.i18n import t
+from lighthouse.out import Out
+
+log = logging.getLogger(__name__)
+
+
+@dataclass
+class Context:
+    """Everything a command may use, and nothing global. The tests build one of
+    these, so no command reads `os.environ` or `sys.argv` for itself."""
+    args: argparse.Namespace
+    out: Out
+    config: Config
+    store: Store
+    env: dict[str, str] = field(default_factory=dict)
+    transport: Any = None
+    sleep: Any = None
+    opener: Any = None
+    reader: Any = None
+    stdin: TextIO | None = None
+    _client: Client | None = None
+
+    @property
+    def host(self) -> str:
+        return self.config.host_for(getattr(self.args, "host", None), self.env)
+
+    def client(self, *, anonymous: bool = False) -> Client:
+        """A client for the resolved host. `anonymous` for the routes that take
+        no credential (the device-code request and the token endpoint)."""
+        if self._client is None:
+            host = self.host
+            credential = None if anonymous else self.store.require(host)
+            self._client = self.new_client(host, credential)
+        return self._client
+
+    def new_client(self, host: str, credential: Any, *,
+                   access: tuple[str, str] | None = None,
+                   session: str | None = None) -> Client:
+        """A client with this run's `--timeout` applied. Every client in the
+        program is made here, so the flag cannot be forgotten by one command."""
+        return Client(host, credential, store=self.store, transport=self.transport,
+                      sleep=self.sleep, timeout=getattr(self.args, "timeout", None),
+                      access=access, session=session)
+
+    def confirm(self, question: str) -> bool:
+        """Ask, unless `--yes`. Under `--no-input` an unanswered question is
+        exit 7, never a silent yes: a CI run must not approve anything by
+        default."""
+        if getattr(self.args, "yes", False):
+            return True
+        if getattr(self.args, "no_input", False) or not sys.stdin.isatty():
+            raise exits.NeedsAPerson(question)
+        answer = (self.reader or input)(f"{question} {t('confirm.suffix')} ").strip().lower()
+        return answer in {"y", "yes", *i18n.yes_answers()}
+
+
+Handler = Callable[[Context], Any]
+Shower = Callable[[Out, Any], None]
+
+
+@dataclass(frozen=True)
+class Command:
+    name: str
+    help: str
+    configure: Callable[[argparse.ArgumentParser], None]
+    handler: Handler
+    show: Shower
+    anonymous: bool = False
+
+
+def commands() -> dict[str, Command]:
+    """Imported here rather than at module scope so `lighthouse --version`
+    costs one import, not twelve."""
+    from lighthouse.commands import (
+        agents,
+        builds,
+        collectors,
+        connect,
+        connections,
+        evals,
+        kb,
+        language,
+        limits,
+        login,
+        models,
+        runs,
+        spend,
+        stack,
+        terms,
+        whoami,
+    )
+    out: dict[str, Command] = {}
+    for module in (login, whoami, connect, connections, collectors, models, kb, agents, builds, evals,
+                   runs, spend, limits, terms, stack, language):
+        for command in module.COMMANDS:
+            out[command.name] = command
+    return out
+
+
+def parser(registry: dict[str, Command]) -> argparse.ArgumentParser:
+    """The root parser and one subparser per command.
+
+    The global options come from `flags.py`, which explains why they are
+    declared twice and what `SUPPRESS` is for. Each command's own
+    `configure` attaches `flags.inherited()` to any subparser of its own, so
+    `--json` works at every depth.
+    """
+    ap = argparse.ArgumentParser(
+        prog="lighthouse", add_help=True,
+        description=t("main.description"), epilog=t("main.epilog"))
+    ap.add_argument("--version", action="version", version=f"lighthouse {__version__}")
+
+    flags.add(ap, suppress=False)
+    common = flags.inherited()
+    subs = ap.add_subparsers(dest="command", metavar="<command>")
+    for command in registry.values():
+        sub = subs.add_parser(command.name, parents=[common], help=command.help,
+                              description=command.help)
+        command.configure(sub)
+    return i18n.localise(ap)
+
+
+def main(argv: list[str] | None = None, *, env: dict[str, str] | None = None,
+         stdout: TextIO | None = None, stderr: TextIO | None = None,
+         store: Store | None = None, config: Config | None = None,
+         transport: Any = None, sleep: Any = None, opener: Any = None,
+         reader: Any = None, isatty: bool | None = None,
+         stdin: TextIO | None = None) -> int:
+    env = env if env is not None else dict(os.environ)
+    argv = list(sys.argv[1:] if argv is None else argv)
+    # The language first: the parser's own help has to be in it (i18n.py).
+    try:
+        config = config if config is not None else Config.load(env)
+        known: str | None = config.host_for(None, env)
+        config_dir: Path | None = config.path.parent
+    except CliError:
+        known, config_dir = None, None
+    i18n.use(i18n.choose(argv, env, config_dir, known))
+    registry = commands()
+    ap = parser(registry)
+    try:
+        args = ap.parse_args(argv)
+    except SystemExit as e:                     # argparse's own --help and errors
+        return int(e.code or 0)
+    out = Out(as_json=bool(args.as_json), quiet=bool(args.quiet), stdout=stdout,
+              stderr=stderr, env=env, isatty=isatty)
+    if args.lang is not None and i18n.normalise(args.lang) is None:
+        refusal = CliError(t("err.unsupported_language", lang=args.lang), code=exits.USAGE,
+                           error="usage", hint=t("hint.unsupported_language", tags=", ".join(i18n.TAGS)))
+        if out.as_json:
+            out.json(refusal.body())
+        else:
+            out.fail(refusal.message, hint=refusal.hint)
+        return refusal.code
+    if not args.command:
+        ap.print_help(file=out.stderr)
+        return exits.USAGE
+    command = registry[args.command]
+    context = Context(args=args, out=out,
+                      config=config if config is not None else Config.load(env),
+                      store=store if store is not None else Store(env=env),
+                      env=env, transport=transport, sleep=sleep, opener=opener, reader=reader,
+                      stdin=stdin)
+    try:
+        body = command.handler(context)
+    except CliError as e:
+        if out.as_json:
+            out.json(e.body())
+        else:
+            out.fail(e.message, hint=e.hint)
+        return e.code
+    except KeyboardInterrupt:                   # pragma: no cover - a person's Ctrl-C
+        out.note(t("note.stopped"))
+        return 130
+    finally:
+        if context._client is not None:
+            context._client.close()
+    if out.as_json:
+        if not out.streamed:
+            out.json(body if isinstance(body, dict) else {"ok": True, "result": body})
+    else:
+        command.show(out, body)
+    return exits.OK
+
+
+def run() -> None:                              # pragma: no cover - the console script
+    sys.exit(main())