@link-assistant/hive-mind 1.65.2 → 1.66.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @link-assistant/hive-mind
 
+## 1.66.0
+
+### Minor Changes
+
+- f744d5a: Add internationalisation (i18n) for user-facing terminal output and the Telegram bot. Translations are stored in `links-notation` files under `src/locales/` (`en`, `ru`, `zh`, `hi`) and loaded via `lino-objects-codec`. Adds a `--language <en|ru|zh|hi>` option to `solve`, `hive`, `task`, and `review` (defaults to detected system locale). The Telegram bot picks each user's language from `ctx.from.language_code` with a per-user override settable through a new `/language <code|default>` command (in-memory, resets on bot restart). Built-in commands `/limits`, `/version`, `/solve`, `/hive`, and `/language` now reply in the user's selected language. AI prompts are intentionally untouched - only human-facing strings are translated.
+
 ## 1.65.2
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@link-assistant/hive-mind",
-  "version": "1.65.2",
+  "version": "1.66.0",
   "description": "AI-powered issue solver and hive mind for collaborative problem solving",
   "main": "src/hive.mjs",
   "type": "module",
@@ -76,6 +76,7 @@
     "dayjs": "^1.11.19",
     "decimal.js-light": "^2.5.1",
     "lino-arguments": "^0.3.0",
+    "lino-objects-codec": "^0.3.6",
     "secretlint": "^11.2.5",
     "semver": "^7.7.3"
   },

package/src/hive.mjs

@@ -292,6 +292,10 @@ if (isRunningDirectly) {
     // Set global verbose mode
     global.verboseMode = argv.verbose;
 
+    // Initialize i18n based on --language (or detected system locale)
+    const { initI18n } = await import('./i18n.lib.mjs');
+    await initI18n(argv.language);
+
     setupVerboseLogInterceptor(); // Issue #1466: capture [VERBOSE] output in log files
     setupStdioLogInterceptor(); // Issue #1549: capture ALL terminal output in log file
 

package/src/i18n.lib.mjs

@@ -0,0 +1,174 @@
+// i18n module for hive-mind.
+// - Translation files live in src/locales/<locale>.lino and are stored
+//   in Links Notation, parsed via lino-objects-codec.
+// - Supported locales: en (default fallback), ru, zh, hi.
+// - Public API: initI18n, t, getCurrentLocale, setLocale, getSupportedLocales,
+//   normalizeLocale, getUserLocale, setUserLocale, clearUserLocale,
+//   resolveLocaleFromTelegramCtx.
+
+import { promises as fs } from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { parseIndented } from 'lino-objects-codec';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+const DEFAULT_LOCALE = 'en';
+const SUPPORTED_LOCALES = ['en', 'ru', 'zh', 'hi'];
+
+const localeCache = new Map(); // locale -> { key: string }
+const userLocales = new Map(); // userId/chatId -> locale (in-memory)
+
+let currentLocale = DEFAULT_LOCALE;
+let fallbackLoaded = false;
+
+export function getSupportedLocales() {
+  return [...SUPPORTED_LOCALES];
+}
+
+export function normalizeLocale(input) {
+  if (!input || typeof input !== 'string') return null;
+  const lower = input.toLowerCase();
+  // Take only the language part (before "_" or "-")
+  const lang = lower.split(/[_\-.]/)[0];
+  if (SUPPORTED_LOCALES.includes(lang)) return lang;
+  return null;
+}
+
+export function detectLocale() {
+  const envLocale = process.env.LANG || process.env.LANGUAGE || process.env.LC_ALL || process.env.LC_MESSAGES || '';
+  return normalizeLocale(envLocale) || DEFAULT_LOCALE;
+}
+
+async function readLocaleFile(locale) {
+  const localesDir = path.join(__dirname, 'locales');
+  const linoFile = path.join(localesDir, `${locale}.lino`);
+  const data = await fs.readFile(linoFile, 'utf-8');
+  return parseIndentedToFlatMap(data);
+}
+
+// parseIndented returns { id, obj } where obj is the key->value map.
+// Some keys contain dots (e.g., error.invalid_github_url). The parser
+// supports them when the key is a plain reference (no spaces/quotes).
+function unescapeString(s) {
+  // Convert literal escape sequences (e.g., "\n" inside a quoted string in
+  // Links Notation) into the corresponding JS characters. This keeps the
+  // .lino files single-line and human-friendly.
+  return s.replace(/\\n/g, '\n').replace(/\\t/g, '\t').replace(/\\r/g, '\r').replace(/\\\\/g, '\\');
+}
+
+function parseIndentedToFlatMap(text) {
+  const parsed = parseIndented({ text });
+  // parsed: { id: <localeName>, obj: { key: value, ... } }
+  if (!parsed || !parsed.obj) return {};
+  const out = {};
+  for (const [k, v] of Object.entries(parsed.obj)) {
+    out[k] = typeof v === 'string' ? unescapeString(v) : String(v);
+  }
+  return out;
+}
+
+export async function loadTranslations(locale) {
+  if (localeCache.has(locale)) return localeCache.get(locale);
+
+  let translations = {};
+  try {
+    translations = await readLocaleFile(locale);
+  } catch {
+    translations = {};
+  }
+  localeCache.set(locale, translations);
+
+  // Always have the fallback (English) ready
+  if (!fallbackLoaded && locale !== DEFAULT_LOCALE) {
+    try {
+      const fb = await readLocaleFile(DEFAULT_LOCALE);
+      localeCache.set(DEFAULT_LOCALE, fb);
+    } catch {
+      localeCache.set(DEFAULT_LOCALE, {});
+    }
+    fallbackLoaded = true;
+  } else if (locale === DEFAULT_LOCALE) {
+    fallbackLoaded = true;
+  }
+
+  return translations;
+}
+
+export async function initI18n(localeInput = null) {
+  const requested = localeInput ? normalizeLocale(localeInput) : null;
+  const detectedLocale = requested || detectLocale();
+  currentLocale = detectedLocale;
+  await loadTranslations(detectedLocale);
+  if (detectedLocale !== DEFAULT_LOCALE) {
+    await loadTranslations(DEFAULT_LOCALE);
+  }
+  return detectedLocale;
+}
+
+function applyParams(text, params) {
+  if (!params) return text;
+  let out = text;
+  for (const [k, v] of Object.entries(params)) {
+    out = out.replace(new RegExp(`{{${k}}}`, 'g'), String(v));
+  }
+  return out;
+}
+
+export function t(key, params = {}, options = {}) {
+  const locale = options.locale ? normalizeLocale(options.locale) || currentLocale : currentLocale;
+  const main = localeCache.get(locale) || {};
+  const fallback = localeCache.get(DEFAULT_LOCALE) || {};
+  const value = main[key] ?? fallback[key] ?? key;
+  return applyParams(value, params);
+}
+
+export function getCurrentLocale() {
+  return currentLocale;
+}
+
+export function setLocale(locale) {
+  const normalized = normalizeLocale(locale);
+  if (normalized) currentLocale = normalized;
+}
+
+// In-memory per-user locale store (used by the Telegram bot).
+export function getUserLocale(userId) {
+  if (userId === undefined || userId === null) return null;
+  return userLocales.get(String(userId)) || null;
+}
+
+export function setUserLocale(userId, locale) {
+  const normalized = normalizeLocale(locale);
+  if (!normalized || userId === undefined || userId === null) return false;
+  userLocales.set(String(userId), normalized);
+  return true;
+}
+
+export function clearUserLocale(userId) {
+  if (userId === undefined || userId === null) return false;
+  return userLocales.delete(String(userId));
+}
+
+// Resolve the best locale for a Telegram update context.
+// Priority: per-user override -> ctx.from.language_code -> current default.
+export function resolveLocaleFromTelegramCtx(ctx) {
+  const userId = ctx?.from?.id;
+  const userOverride = getUserLocale(userId);
+  if (userOverride) return userOverride;
+  const fromTelegram = normalizeLocale(ctx?.from?.language_code);
+  if (fromTelegram) return fromTelegram;
+  return currentLocale;
+}
+
+// Pre-load every supported locale (handy for the Telegram bot at startup).
+export async function preloadAllLocales() {
+  for (const loc of SUPPORTED_LOCALES) {
+    try {
+      await loadTranslations(loc);
+    } catch {
+      // ignore - missing files fall back to English
+    }
+  }
+}

package/src/locales/en.lino

@@ -0,0 +1,93 @@
+en
+  error "Error"
+  success "Success"
+  warning "Warning"
+  failed "Failed"
+  info "Info"
+  error.invalid_github_url "Error: Invalid GitHub URL format"
+  error.invalid_github_url_monitoring "Error: Invalid GitHub URL for monitoring"
+  error.missing_required_url "Error: Missing required github issue or pull request URL"
+  error.unable_determine_version "Error: Unable to determine version"
+  error.invalid_url_type "Error: Invalid GitHub URL format"
+  error.url_type_not_supported "URL type '{{type}}' is not supported"
+  error.failed_to_get_current_user "Error: Failed to get current user"
+  error.failed_to_initialize_repository "Error: Failed to initialize repository"
+  error.failed_to_create_fork "Failed to create fork after all retries"
+  error.fork_not_accessible "Fork exists but not accessible after multiple retries"
+  error.failed_to_add_upstream_remote "Failed to add upstream remote"
+  error.failed_to_checkout "Failed to checkout {{branch}}"
+  error.failed_to_sync "Failed to sync {{branch}} with upstream"
+  error.failed_to_get_default_branch "Failed to get default branch name"
+  error.failed_to_get_current_branch "Failed to get current branch"
+  error.failed_to_fetch_upstream "Failed to fetch upstream"
+  error.failed_to_add_pr_fork_remote "Failed to add pr-fork remote"
+  error.failed_to_fetch_from_pr_fork "Failed to fetch from pr-fork"
+  error.pr_does_not_exist "Error: PR #{{prNumber}} does not exist in {{owner}}/{{repo}}"
+  error.youtrack_url_detected_no_config "Error: YouTrack URL detected but YouTrack configuration not found"
+  error.telegram_bot_token_not_set "Error: TELEGRAM_BOT_TOKEN environment variable or --token option is not set"
+  error.invalid_github_url_solve "Error: Invalid GitHub URL for solve command"
+  error.invalid_language "Invalid language '{{value}}'. Supported: {{supported}}"
+  success.readme_created "README.md created successfully"
+  success.process_completed "Process completed"
+  success.error_reported_to_sentry "Error reported to Sentry successfully"
+  success.language_set "Language set to {{language}}"
+  warning.session_log_not_found "Warning: Session log for {{session}} not found, but continuing with resume attempt"
+  warning.failed_to_create_readme "Failed: Could not create README.md"
+  warning.could_not_determine_root_repository "Could not determine root repository"
+  warning.could_not_check_fork_status "Warning: Could not check fork status: {{message}}"
+  warning.no_linked_issue_found "Warning: No linked issue found in PR body"
+  warning.could_not_search_for_existing_prs "Warning: Could not search for existing PRs: {{message}}"
+  warning.could_not_get_current_user "Warning: Could not get current GitHub user"
+  warning.could_not_check_github_permissions "Warning: Could not check GitHub permissions: {{message}}"
+  warning.could_not_determine_token_scopes "Warning: Could not determine token scopes from auth status"
+  warning.failed_to_fetch_branches "Warning: Failed to fetch branches from remote"
+  warning.error_during_auto_pr_creation "Warning: Error during auto PR creation: {{message}}"
+  warning.could_not_convert_pr_to_draft "Warning: Could not convert PR to draft"
+  warning.could_not_check_convert_pr_draft_status "Warning: Could not check/convert PR draft status"
+  warning.could_not_post_work_start_comment "Warning: Could not post work start comment"
+  warning.could_not_post_work_end_comment "Warning: Could not post work end comment"
+  warning.could_not_convert_pr_to_ready "Warning: Could not convert PR to ready"
+  warning.could_not_convert_pr_to_ready_status "Warning: Could not convert PR to ready status"
+  warning.pr_created_but_no_url "Warning: PR created but no URL returned"
+  warning.could_not_assign_user "Could not assign user"
+  info.expected_github_url_format "Expected: https://github.com/owner or https://github.com/owner/repo"
+  info.you_can_use_formats "You can use any of these formats:"
+  info.format_https_owner "- https://github.com/owner"
+  info.format_https_owner_repo "- https://github.com/owner/repo"
+  info.format_http_owner "- http://github.com/owner (will be converted to https)"
+  info.format_github_owner "- github.com/owner (will add https://)"
+  info.format_owner "- owner (will be converted to https://github.com/owner)"
+  info.format_owner_repo "- owner/repo (will be converted to https://github.com/owner/repo)"
+  info.full_log_file "Full log file: {{path}}"
+  info.process_exited_with_code "Process exited with code {{code}}"
+  info.current_configuration "Current Configuration:"
+  process.using_repository_fallback "Using repository-by-repository fallback for {{scope}}: {{owner}}"
+  process.fetching_repository_list "Fetching repository list..."
+  process.command "Command: {{command}}"
+  check.number "Check #{{iteration}}:"
+  time.current "Current time: {{time}}"
+  telegram.fetching_limits "🔄 Fetching usage limits..."
+  telegram.gathering_version "🔄 Gathering version information..."
+  telegram.usage_limits_title "📊 *Usage Limits*"
+  telegram.version_information_title "🤖 *Version Information*"
+  telegram.limits_only_in_groups "❌ The /limits command only works in group chats. Please add this bot to a group and make it an admin."
+  telegram.version_only_in_groups "❌ The /version command only works in group chats. Please add this bot to a group and make it an admin."
+  telegram.solve_only_in_groups "❌ The {{commandDisplay}} command only works in group chats. Please add this bot to a group and make it an admin."
+  telegram.hive_only_in_groups "❌ The /hive command only works in group chats. Please add this bot to a group and make it an admin."
+  telegram.solve_disabled "❌ The solve command is disabled on this bot instance."
+  telegram.hive_disabled "❌ The /hive command is disabled on this bot instance."
+  telegram.no_github_link_in_reply "❌ No GitHub issue/PR link found in the replied message.\n\nExample: Reply to a message containing a GitHub issue link with `/solve`\n\nOr with options: `/solve --model opus`"
+  telegram.invalid_options "❌ Invalid options: {{message}}\n\nUse /help to see available options"
+  telegram.invalid_isolation "❌ Invalid --isolation value '{{value}}'. Must be: screen, tmux, or docker"
+  telegram.invalid_locked_isolation "❌ Invalid locked --isolation value '{{value}}'. Must be: screen, tmux, or docker"
+  telegram.option_syntax_check "Please check your option syntax."
+  telegram.url_status_active "❌ This URL is {{statusText}}.\n\nURL: {{url}}\nStatus: {{status}}\n\n💡 Use /solve_queue to check the queue status."
+  telegram.url_session_running "❌ A working session is already running for this URL.\n\nURL: {{url}}\nSession: `{{session}}`\n\n💡 Wait for the current session to complete, or use /solve\\_stop to cancel it."
+  telegram.solve_rejected "❌ Solve command rejected.\n\n{{infoBlock}}\n\n🚫 Reason: {{reason}}"
+  telegram.language_invalid "❌ Invalid language. Supported: {{supported}}.\nUsage: /language <code>"
+  telegram.language_set "✅ Language set to *{{language}}*."
+  telegram.language_current "🌐 Current language: *{{language}}*.\nSupported: {{supported}}.\nUsage: /language <code>"
+  language.en "English"
+  language.ru "Russian"
+  language.zh "Chinese"
+  language.hi "Hindi"

package/src/locales/hi.lino

@@ -0,0 +1,93 @@
+hi
+  error "त्रुटि"
+  success "सफल"
+  warning "चेतावनी"
+  failed "विफल"
+  info "सूचना"
+  error.invalid_github_url "त्रुटि: अमान्य GitHub URL प्रारूप"
+  error.invalid_github_url_monitoring "त्रुटि: निगरानी के लिए अमान्य GitHub URL"
+  error.missing_required_url "त्रुटि: आवश्यक GitHub issue या pull request URL गायब है"
+  error.unable_determine_version "त्रुटि: संस्करण निर्धारित करने में असमर्थ"
+  error.invalid_url_type "त्रुटि: अमान्य GitHub URL प्रारूप"
+  error.url_type_not_supported "URL प्रकार '{{type}}' समर्थित नहीं है"
+  error.failed_to_get_current_user "त्रुटि: वर्तमान उपयोगकर्ता प्राप्त करने में विफल"
+  error.failed_to_initialize_repository "त्रुटि: रिपॉजिटरी आरंभ करने में विफल"
+  error.failed_to_create_fork "सभी प्रयासों के बाद fork बनाने में विफल"
+  error.fork_not_accessible "Fork मौजूद है लेकिन कई प्रयासों के बाद भी पहुँच योग्य नहीं"
+  error.failed_to_add_upstream_remote "upstream रिमोट जोड़ने में विफल"
+  error.failed_to_checkout "{{branch}} पर स्विच करने में विफल"
+  error.failed_to_sync "{{branch}} को upstream के साथ सिंक करने में विफल"
+  error.failed_to_get_default_branch "डिफ़ॉल्ट शाखा का नाम प्राप्त करने में विफल"
+  error.failed_to_get_current_branch "वर्तमान शाखा प्राप्त करने में विफल"
+  error.failed_to_fetch_upstream "upstream से डेटा प्राप्त करने में विफल"
+  error.failed_to_add_pr_fork_remote "pr-fork रिमोट जोड़ने में विफल"
+  error.failed_to_fetch_from_pr_fork "pr-fork से डेटा प्राप्त करने में विफल"
+  error.pr_does_not_exist "त्रुटि: PR #{{prNumber}} {{owner}}/{{repo}} में मौजूद नहीं है"
+  error.youtrack_url_detected_no_config "त्रुटि: YouTrack URL का पता चला लेकिन YouTrack कॉन्फ़िगरेशन नहीं मिला"
+  error.telegram_bot_token_not_set "त्रुटि: TELEGRAM_BOT_TOKEN पर्यावरण चर या --token विकल्प सेट नहीं है"
+  error.invalid_github_url_solve "त्रुटि: solve कमांड के लिए अमान्य GitHub URL"
+  error.invalid_language "अमान्य भाषा '{{value}}'. समर्थित: {{supported}}"
+  success.readme_created "README.md सफलतापूर्वक बनाया गया"
+  success.process_completed "प्रक्रिया पूरी हुई"
+  success.error_reported_to_sentry "त्रुटि सफलतापूर्वक Sentry को रिपोर्ट की गई"
+  success.language_set "भाषा सेट की गई: {{language}}"
+  warning.session_log_not_found "चेतावनी: सत्र {{session}} के लिए लॉग नहीं मिला, लेकिन फिर से शुरू करने का प्रयास जारी है"
+  warning.failed_to_create_readme "विफल: README.md नहीं बना सका"
+  warning.could_not_determine_root_repository "रूट रिपॉजिटरी निर्धारित नहीं की जा सकी"
+  warning.could_not_check_fork_status "चेतावनी: fork स्थिति की जाँच नहीं हो सकी: {{message}}"
+  warning.no_linked_issue_found "चेतावनी: PR विवरण में कोई जुड़ा हुआ issue नहीं मिला"
+  warning.could_not_search_for_existing_prs "चेतावनी: मौजूदा PR नहीं ढूँढ सके: {{message}}"
+  warning.could_not_get_current_user "चेतावनी: वर्तमान GitHub उपयोगकर्ता प्राप्त नहीं हो सका"
+  warning.could_not_check_github_permissions "चेतावनी: GitHub अनुमतियाँ जाँच नहीं सकी: {{message}}"
+  warning.could_not_determine_token_scopes "चेतावनी: ऑथ स्थिति से टोकन स्कोप निर्धारित नहीं हो सके"
+  warning.failed_to_fetch_branches "चेतावनी: रिमोट से शाखाएँ प्राप्त करने में विफल"
+  warning.error_during_auto_pr_creation "चेतावनी: स्वचालित PR निर्माण के दौरान त्रुटि: {{message}}"
+  warning.could_not_convert_pr_to_draft "चेतावनी: PR को draft में परिवर्तित नहीं कर सका"
+  warning.could_not_check_convert_pr_draft_status "चेतावनी: PR draft स्थिति की जाँच/परिवर्तन नहीं हो सका"
+  warning.could_not_post_work_start_comment "चेतावनी: कार्य प्रारंभ टिप्पणी पोस्ट नहीं कर सका"
+  warning.could_not_post_work_end_comment "चेतावनी: कार्य समाप्ति टिप्पणी पोस्ट नहीं कर सका"
+  warning.could_not_convert_pr_to_ready "चेतावनी: PR को ready में परिवर्तित नहीं कर सका"
+  warning.could_not_convert_pr_to_ready_status "चेतावनी: PR स्थिति को ready में परिवर्तित नहीं कर सका"
+  warning.pr_created_but_no_url "चेतावनी: PR बनाया गया लेकिन URL वापस नहीं आया"
+  warning.could_not_assign_user "उपयोगकर्ता नियुक्त नहीं कर सका"
+  info.expected_github_url_format "अपेक्षित: https://github.com/owner या https://github.com/owner/repo"
+  info.you_can_use_formats "आप इनमें से किसी भी प्रारूप का उपयोग कर सकते हैं:"
+  info.format_https_owner "- https://github.com/owner"
+  info.format_https_owner_repo "- https://github.com/owner/repo"
+  info.format_http_owner "- http://github.com/owner (https में परिवर्तित होगा)"
+  info.format_github_owner "- github.com/owner (https:// जोड़ा जाएगा)"
+  info.format_owner "- owner (https://github.com/owner में परिवर्तित होगा)"
+  info.format_owner_repo "- owner/repo (https://github.com/owner/repo में परिवर्तित होगा)"
+  info.full_log_file "पूरा लॉग फ़ाइल: {{path}}"
+  info.process_exited_with_code "प्रक्रिया कोड {{code}} के साथ समाप्त हुई"
+  info.current_configuration "वर्तमान कॉन्फ़िगरेशन:"
+  process.using_repository_fallback "{{scope}} के लिए रिपॉजिटरी-दर-रिपॉजिटरी फ़ॉलबैक का उपयोग: {{owner}}"
+  process.fetching_repository_list "रिपॉजिटरी सूची प्राप्त की जा रही है..."
+  process.command "कमांड: {{command}}"
+  check.number "जाँच #{{iteration}}:"
+  time.current "वर्तमान समय: {{time}}"
+  telegram.fetching_limits "🔄 उपयोग सीमाएँ प्राप्त की जा रही हैं..."
+  telegram.gathering_version "🔄 संस्करण जानकारी एकत्र की जा रही है..."
+  telegram.usage_limits_title "📊 *उपयोग सीमाएँ*"
+  telegram.version_information_title "🤖 *संस्करण जानकारी*"
+  telegram.limits_only_in_groups "❌ /limits कमांड केवल समूह चैट में काम करती है। कृपया बॉट को समूह में जोड़ें और व्यवस्थापक बनाएँ।"
+  telegram.version_only_in_groups "❌ /version कमांड केवल समूह चैट में काम करती है। कृपया बॉट को समूह में जोड़ें और व्यवस्थापक बनाएँ।"
+  telegram.solve_only_in_groups "❌ {{commandDisplay}} कमांड केवल समूह चैट में काम करती है। कृपया बॉट को समूह में जोड़ें और व्यवस्थापक बनाएँ।"
+  telegram.hive_only_in_groups "❌ /hive कमांड केवल समूह चैट में काम करती है। कृपया बॉट को समूह में जोड़ें और व्यवस्थापक बनाएँ।"
+  telegram.solve_disabled "❌ इस बॉट इंस्टेंस पर solve कमांड अक्षम है।"
+  telegram.hive_disabled "❌ इस बॉट इंस्टेंस पर /hive कमांड अक्षम है।"
+  telegram.no_github_link_in_reply "❌ उत्तर दिए गए संदेश में कोई GitHub issue/PR लिंक नहीं मिला।\n\nउदाहरण: GitHub issue लिंक वाले संदेश का उत्तर `/solve` से दें\n\nया विकल्पों के साथ: `/solve --model opus`"
+  telegram.invalid_options "❌ अमान्य विकल्प: {{message}}\n\nउपलब्ध विकल्प देखने के लिए /help का उपयोग करें"
+  telegram.invalid_isolation "❌ अमान्य --isolation मान '{{value}}'। होना चाहिए: screen, tmux, या docker"
+  telegram.invalid_locked_isolation "❌ अमान्य लॉक्ड --isolation मान '{{value}}'। होना चाहिए: screen, tmux, या docker"
+  telegram.option_syntax_check "कृपया अपने विकल्प सिंटैक्स की जाँच करें।"
+  telegram.url_status_active "❌ यह URL {{statusText}} है।\n\nURL: {{url}}\nस्थिति: {{status}}\n\n💡 कतार स्थिति देखने के लिए /solve_queue का उपयोग करें।"
+  telegram.url_session_running "❌ इस URL के लिए पहले से एक कार्य सत्र चल रहा है।\n\nURL: {{url}}\nसत्र: `{{session}}`\n\n💡 वर्तमान सत्र के पूरा होने की प्रतीक्षा करें, या रद्द करने के लिए /solve\\_stop का उपयोग करें।"
+  telegram.solve_rejected "❌ Solve कमांड अस्वीकृत।\n\n{{infoBlock}}\n\n🚫 कारण: {{reason}}"
+  telegram.language_invalid "❌ अमान्य भाषा। समर्थित: {{supported}}।\nउपयोग: /language <कोड>"
+  telegram.language_set "✅ भाषा सेट: *{{language}}*।"
+  telegram.language_current "🌐 वर्तमान भाषा: *{{language}}*।\nसमर्थित: {{supported}}।\nउपयोग: /language <कोड>"
+  language.en "अंग्रेज़ी"
+  language.ru "रूसी"
+  language.zh "चीनी"
+  language.hi "हिन्दी"

package/src/locales/ru.lino

@@ -0,0 +1,93 @@
+ru
+  error "Ошибка"
+  success "Успешно"
+  warning "Предупреждение"
+  failed "Не удалось"
+  info "Информация"
+  error.invalid_github_url "Ошибка: Неверный формат URL GitHub"
+  error.invalid_github_url_monitoring "Ошибка: Неверный URL GitHub для мониторинга"
+  error.missing_required_url "Ошибка: Отсутствует обязательный URL проблемы или запроса на слияние GitHub"
+  error.unable_determine_version "Ошибка: Не удается определить версию"
+  error.invalid_url_type "Ошибка: Неверный формат URL GitHub"
+  error.url_type_not_supported "Тип URL '{{type}}' не поддерживается"
+  error.failed_to_get_current_user "Ошибка: Не удалось получить текущего пользователя"
+  error.failed_to_initialize_repository "Ошибка: Не удалось инициализировать репозиторий"
+  error.failed_to_create_fork "Не удалось создать форк после всех попыток"
+  error.fork_not_accessible "Форк существует, но недоступен после нескольких попыток"
+  error.failed_to_add_upstream_remote "Не удалось добавить удалённый репозиторий upstream"
+  error.failed_to_checkout "Не удалось переключиться на {{branch}}"
+  error.failed_to_sync "Не удалось синхронизировать {{branch}} с upstream"
+  error.failed_to_get_default_branch "Не удалось получить имя ветки по умолчанию"
+  error.failed_to_get_current_branch "Не удалось получить текущую ветку"
+  error.failed_to_fetch_upstream "Не удалось получить данные из upstream"
+  error.failed_to_add_pr_fork_remote "Не удалось добавить удалённый репозиторий pr-fork"
+  error.failed_to_fetch_from_pr_fork "Не удалось получить данные из pr-fork"
+  error.pr_does_not_exist "Ошибка: PR #{{prNumber}} не существует в {{owner}}/{{repo}}"
+  error.youtrack_url_detected_no_config "Ошибка: Обнаружен URL YouTrack, но конфигурация YouTrack не найдена"
+  error.telegram_bot_token_not_set "Ошибка: Переменная окружения TELEGRAM_BOT_TOKEN или опция --token не установлена"
+  error.invalid_github_url_solve "Ошибка: Неверный URL GitHub для команды solve"
+  error.invalid_language "Неверный язык '{{value}}'. Поддерживаются: {{supported}}"
+  success.readme_created "README.md успешно создан"
+  success.process_completed "Процесс завершён"
+  success.error_reported_to_sentry "Ошибка успешно отправлена в Sentry"
+  success.language_set "Язык установлен: {{language}}"
+  warning.session_log_not_found "Предупреждение: Журнал сеанса для {{session}} не найден, но продолжаем попытку возобновления"
+  warning.failed_to_create_readme "Не удалось: Не удалось создать README.md"
+  warning.could_not_determine_root_repository "Не удалось определить корневой репозиторий"
+  warning.could_not_check_fork_status "Предупреждение: Не удалось проверить статус форка: {{message}}"
+  warning.no_linked_issue_found "Предупреждение: Связанная проблема не найдена в теле PR"
+  warning.could_not_search_for_existing_prs "Предупреждение: Не удалось найти существующие PR: {{message}}"
+  warning.could_not_get_current_user "Предупреждение: Не удалось получить текущего пользователя GitHub"
+  warning.could_not_check_github_permissions "Предупреждение: Не удалось проверить разрешения GitHub: {{message}}"
+  warning.could_not_determine_token_scopes "Предупреждение: Не удалось определить области токена из статуса аутентификации"
+  warning.failed_to_fetch_branches "Предупреждение: Не удалось получить ветки из удалённого репозитория"
+  warning.error_during_auto_pr_creation "Предупреждение: Ошибка при автоматическом создании PR: {{message}}"
+  warning.could_not_convert_pr_to_draft "Предупреждение: Не удалось преобразовать PR в черновик"
+  warning.could_not_check_convert_pr_draft_status "Предупреждение: Не удалось проверить/преобразовать статус черновика PR"
+  warning.could_not_post_work_start_comment "Предупреждение: Не удалось опубликовать комментарий о начале работы"
+  warning.could_not_post_work_end_comment "Предупреждение: Не удалось опубликовать комментарий о завершении работы"
+  warning.could_not_convert_pr_to_ready "Предупреждение: Не удалось преобразовать PR в готовый"
+  warning.could_not_convert_pr_to_ready_status "Предупреждение: Не удалось преобразовать статус PR в готовый"
+  warning.pr_created_but_no_url "Предупреждение: PR создан, но URL не возвращён"
+  warning.could_not_assign_user "Не удалось назначить пользователя"
+  info.expected_github_url_format "Ожидается: https://github.com/owner или https://github.com/owner/repo"
+  info.you_can_use_formats "Вы можете использовать любой из этих форматов:"
+  info.format_https_owner "- https://github.com/owner"
+  info.format_https_owner_repo "- https://github.com/owner/repo"
+  info.format_http_owner "- http://github.com/owner (будет преобразовано в https)"
+  info.format_github_owner "- github.com/owner (будет добавлено https://)"
+  info.format_owner "- owner (будет преобразовано в https://github.com/owner)"
+  info.format_owner_repo "- owner/repo (будет преобразовано в https://github.com/owner/repo)"
+  info.full_log_file "Полный файл журнала: {{path}}"
+  info.process_exited_with_code "Процесс завершился с кодом {{code}}"
+  info.current_configuration "Текущая конфигурация:"
+  process.using_repository_fallback "Использование резервного метода репозиторий-за-репозиторием для {{scope}}: {{owner}}"
+  process.fetching_repository_list "Получение списка репозиториев..."
+  process.command "Команда: {{command}}"
+  check.number "Проверка #{{iteration}}:"
+  time.current "Текущее время: {{time}}"
+  telegram.fetching_limits "🔄 Получение лимитов использования..."
+  telegram.gathering_version "🔄 Сбор информации о версии..."
+  telegram.usage_limits_title "📊 *Лимиты использования*"
+  telegram.version_information_title "🤖 *Информация о версии*"
+  telegram.limits_only_in_groups "❌ Команда /limits работает только в групповых чатах. Добавьте бота в группу и сделайте его администратором."
+  telegram.version_only_in_groups "❌ Команда /version работает только в групповых чатах. Добавьте бота в группу и сделайте его администратором."
+  telegram.solve_only_in_groups "❌ Команда {{commandDisplay}} работает только в групповых чатах. Добавьте бота в группу и сделайте его администратором."
+  telegram.hive_only_in_groups "❌ Команда /hive работает только в групповых чатах. Добавьте бота в группу и сделайте его администратором."
+  telegram.solve_disabled "❌ Команда solve отключена в этом экземпляре бота."
+  telegram.hive_disabled "❌ Команда /hive отключена в этом экземпляре бота."
+  telegram.no_github_link_in_reply "❌ В сообщении, на которое вы ответили, не найдена ссылка на проблему/PR GitHub.\n\nПример: Ответьте на сообщение со ссылкой на проблему GitHub командой `/solve`\n\nИли с опциями: `/solve --model opus`"
+  telegram.invalid_options "❌ Неверные опции: {{message}}\n\nИспользуйте /help, чтобы увидеть доступные опции"
+  telegram.invalid_isolation "❌ Неверное значение --isolation '{{value}}'. Допустимо: screen, tmux или docker"
+  telegram.invalid_locked_isolation "❌ Неверное заблокированное значение --isolation '{{value}}'. Допустимо: screen, tmux или docker"
+  telegram.option_syntax_check "Проверьте синтаксис опций."
+  telegram.url_status_active "❌ Этот URL имеет статус {{statusText}}.\n\nURL: {{url}}\nСтатус: {{status}}\n\n💡 Используйте /solve_queue для проверки очереди."
+  telegram.url_session_running "❌ Для этого URL уже выполняется рабочий сеанс.\n\nURL: {{url}}\nСеанс: `{{session}}`\n\n💡 Дождитесь завершения текущего сеанса или используйте /solve\\_stop для отмены."
+  telegram.solve_rejected "❌ Команда solve отклонена.\n\n{{infoBlock}}\n\n🚫 Причина: {{reason}}"
+  telegram.language_invalid "❌ Неверный язык. Поддерживаются: {{supported}}.\nИспользование: /language <код>"
+  telegram.language_set "✅ Язык установлен: *{{language}}*."
+  telegram.language_current "🌐 Текущий язык: *{{language}}*.\nПоддерживаются: {{supported}}.\nИспользование: /language <код>"
+  language.en "Английский"
+  language.ru "Русский"
+  language.zh "Китайский"
+  language.hi "Хинди"

package/src/locales/zh.lino

@@ -0,0 +1,93 @@
+zh
+  error "错误"
+  success "成功"
+  warning "警告"
+  failed "失败"
+  info "信息"
+  error.invalid_github_url "错误：GitHub URL 格式无效"
+  error.invalid_github_url_monitoring "错误：用于监控的 GitHub URL 无效"
+  error.missing_required_url "错误：缺少必需的 GitHub issue 或 pull request URL"
+  error.unable_determine_version "错误：无法确定版本"
+  error.invalid_url_type "错误：GitHub URL 格式无效"
+  error.url_type_not_supported "URL 类型 '{{type}}' 不受支持"
+  error.failed_to_get_current_user "错误：无法获取当前用户"
+  error.failed_to_initialize_repository "错误：无法初始化仓库"
+  error.failed_to_create_fork "多次重试后仍无法创建 fork"
+  error.fork_not_accessible "Fork 已存在但多次重试后仍无法访问"
+  error.failed_to_add_upstream_remote "无法添加 upstream 远程仓库"
+  error.failed_to_checkout "无法切换到 {{branch}}"
+  error.failed_to_sync "无法将 {{branch}} 与 upstream 同步"
+  error.failed_to_get_default_branch "无法获取默认分支名称"
+  error.failed_to_get_current_branch "无法获取当前分支"
+  error.failed_to_fetch_upstream "无法从 upstream 获取数据"
+  error.failed_to_add_pr_fork_remote "无法添加 pr-fork 远程仓库"
+  error.failed_to_fetch_from_pr_fork "无法从 pr-fork 获取数据"
+  error.pr_does_not_exist "错误：PR #{{prNumber}} 在 {{owner}}/{{repo}} 中不存在"
+  error.youtrack_url_detected_no_config "错误：检测到 YouTrack URL 但未找到 YouTrack 配置"
+  error.telegram_bot_token_not_set "错误：未设置 TELEGRAM_BOT_TOKEN 环境变量或 --token 选项"
+  error.invalid_github_url_solve "错误：solve 命令的 GitHub URL 无效"
+  error.invalid_language "无效的语言 '{{value}}'。支持的语言：{{supported}}"
+  success.readme_created "README.md 创建成功"
+  success.process_completed "进程已完成"
+  success.error_reported_to_sentry "错误已成功上报到 Sentry"
+  success.language_set "语言已设置为 {{language}}"
+  warning.session_log_not_found "警告：未找到会话 {{session}} 的日志，但将继续尝试恢复"
+  warning.failed_to_create_readme "失败：无法创建 README.md"
+  warning.could_not_determine_root_repository "无法确定根仓库"
+  warning.could_not_check_fork_status "警告：无法检查 fork 状态：{{message}}"
+  warning.no_linked_issue_found "警告：在 PR 内容中未找到关联的 issue"
+  warning.could_not_search_for_existing_prs "警告：无法搜索现有的 PR：{{message}}"
+  warning.could_not_get_current_user "警告：无法获取当前 GitHub 用户"
+  warning.could_not_check_github_permissions "警告：无法检查 GitHub 权限：{{message}}"
+  warning.could_not_determine_token_scopes "警告：无法从认证状态确定令牌范围"
+  warning.failed_to_fetch_branches "警告：无法从远程获取分支"
+  warning.error_during_auto_pr_creation "警告：自动创建 PR 时出错：{{message}}"
+  warning.could_not_convert_pr_to_draft "警告：无法将 PR 转换为草稿"
+  warning.could_not_check_convert_pr_draft_status "警告：无法检查/转换 PR 草稿状态"
+  warning.could_not_post_work_start_comment "警告：无法发布工作开始评论"
+  warning.could_not_post_work_end_comment "警告：无法发布工作结束评论"
+  warning.could_not_convert_pr_to_ready "警告：无法将 PR 转换为就绪状态"
+  warning.could_not_convert_pr_to_ready_status "警告：无法将 PR 状态转换为就绪"
+  warning.pr_created_but_no_url "警告：已创建 PR 但未返回 URL"
+  warning.could_not_assign_user "无法分配用户"
+  info.expected_github_url_format "预期格式：https://github.com/owner 或 https://github.com/owner/repo"
+  info.you_can_use_formats "您可以使用以下任意格式："
+  info.format_https_owner "- https://github.com/owner"
+  info.format_https_owner_repo "- https://github.com/owner/repo"
+  info.format_http_owner "- http://github.com/owner（将转换为 https）"
+  info.format_github_owner "- github.com/owner（将添加 https://）"
+  info.format_owner "- owner（将转换为 https://github.com/owner）"
+  info.format_owner_repo "- owner/repo（将转换为 https://github.com/owner/repo）"
+  info.full_log_file "完整日志文件：{{path}}"
+  info.process_exited_with_code "进程退出代码：{{code}}"
+  info.current_configuration "当前配置："
+  process.using_repository_fallback "使用按仓库回退方式处理 {{scope}}：{{owner}}"
+  process.fetching_repository_list "正在获取仓库列表……"
+  process.command "命令：{{command}}"
+  check.number "检查 #{{iteration}}："
+  time.current "当前时间：{{time}}"
+  telegram.fetching_limits "🔄 正在获取使用限额……"
+  telegram.gathering_version "🔄 正在收集版本信息……"
+  telegram.usage_limits_title "📊 *使用限额*"
+  telegram.version_information_title "🤖 *版本信息*"
+  telegram.limits_only_in_groups "❌ /limits 命令仅在群聊中有效。请将本机器人加入群组并设为管理员。"
+  telegram.version_only_in_groups "❌ /version 命令仅在群聊中有效。请将本机器人加入群组并设为管理员。"
+  telegram.solve_only_in_groups "❌ {{commandDisplay}} 命令仅在群聊中有效。请将本机器人加入群组并设为管理员。"
+  telegram.hive_only_in_groups "❌ /hive 命令仅在群聊中有效。请将本机器人加入群组并设为管理员。"
+  telegram.solve_disabled "❌ 此机器人实例已禁用 solve 命令。"
+  telegram.hive_disabled "❌ 此机器人实例已禁用 /hive 命令。"
+  telegram.no_github_link_in_reply "❌ 被回复的消息中未找到 GitHub issue/PR 链接。\n\n示例：使用 `/solve` 回复包含 GitHub issue 链接的消息\n\n或带选项：`/solve --model opus`"
+  telegram.invalid_options "❌ 无效选项：{{message}}\n\n使用 /help 查看可用选项"
+  telegram.invalid_isolation "❌ 无效的 --isolation 值 '{{value}}'。必须是：screen、tmux 或 docker"
+  telegram.invalid_locked_isolation "❌ 无效的锁定 --isolation 值 '{{value}}'。必须是：screen、tmux 或 docker"
+  telegram.option_syntax_check "请检查您的选项语法。"
+  telegram.url_status_active "❌ 此 URL 状态为 {{statusText}}。\n\nURL：{{url}}\n状态：{{status}}\n\n💡 使用 /solve_queue 查看队列状态。"
+  telegram.url_session_running "❌ 该 URL 已有正在运行的工作会话。\n\nURL：{{url}}\n会话：`{{session}}`\n\n💡 等待当前会话完成，或使用 /solve\\_stop 取消。"
+  telegram.solve_rejected "❌ Solve 命令被拒绝。\n\n{{infoBlock}}\n\n🚫 原因：{{reason}}"
+  telegram.language_invalid "❌ 语言无效。支持的语言：{{supported}}。\n用法：/language <代码>"
+  telegram.language_set "✅ 语言已设置为 *{{language}}*。"
+  telegram.language_current "🌐 当前语言：*{{language}}*。\n支持的语言：{{supported}}。\n用法：/language <代码>"
+  language.en "英语"
+  language.ru "俄语"
+  language.zh "中文"
+  language.hi "印地语"

package/src/review.mjs

@@ -101,6 +101,11 @@ const createReviewYargsConfig = yargsInstance =>
       description: 'Execute the AI tool using bunx (experimental, may improve speed and memory usage)',
       default: false,
     })
+    .option('language', {
+      type: 'string',
+      description: 'Language for user-facing output (en, ru, zh, hi). Defaults to detected system locale.',
+      choices: ['en', 'ru', 'zh', 'hi'],
+    })
     .check(parsed => {
       if (!parsed['pr-url'] && !parsed.prUrl && !parsed._?.[0]) {
         throw new Error('The GitHub pull request URL is required');
@@ -128,6 +133,10 @@ const prUrl = argv['pr-url'] || argv.prUrl || argv._[0];
 // Set global verbose mode for log function
 global.verboseMode = argv.verbose;
 
+// Initialize i18n based on --language (or detected system locale)
+const { initI18n } = await import('./i18n.lib.mjs');
+await initI18n(argv.language);
+
 // Create permanent log file immediately with timestamp
 const scriptDir = path.dirname(process.argv[1]);
 const timestamp = new Date().toISOString().replace(/[:.]/g, '-');

package/src/solve.config.lib.mjs

@@ -552,6 +552,11 @@ export const SOLVE_OPTION_DEFINITIONS = {
     description: '[EXPERIMENTAL] Enable live progress monitoring. Accepts "comment" (default, updates a per-session PR comment) or "pr" (updates PR description). Plain --working-session-live-progress means "comment". Works with or without --interactive-mode.',
     default: false,
   },
+  language: {
+    type: 'string',
+    description: 'Language for user-facing output (en, ru, zh, hi). Defaults to detected system locale. Affects terminal status/error messages and bot-generated PR/issue comments. Does not affect AI prompts.',
+    choices: ['en', 'ru', 'zh', 'hi'],
+  },
 };
 
 // Function to create yargs configuration - avoids duplication

package/src/solve.mjs

@@ -84,6 +84,10 @@ try {
 }
 global.verboseMode = argv.verbose;
 
+// Initialize i18n based on --language (or detected system locale)
+const { initI18n } = await import('./i18n.lib.mjs');
+await initI18n(argv.language);
+
 setupVerboseLogInterceptor(); // Issue #1466: capture [VERBOSE] output in log files
 setupStdioLogInterceptor(); // Issue #1549: capture ALL terminal output in log file
 

package/src/task.config.lib.mjs

@@ -85,6 +85,11 @@ export const createYargsConfig = yargsInstance =>
       choices: ['text', 'json'],
       default: 'text',
     })
+    .option('language', {
+      type: 'string',
+      description: 'Language for user-facing output (en, ru, zh, hi). Defaults to detected system locale.',
+      choices: ['en', 'ru', 'zh', 'hi'],
+    })
     .check(argv => {
       if (!argv['task-input'] && !argv._[0]) {
         throw new Error('Please provide a GitHub issue URL or task description');

package/src/task.mjs

@@ -50,6 +50,10 @@ try {
   process.exit(1);
 }
 
+// Initialize i18n based on --language (or detected system locale)
+const { initI18n } = await import('./i18n.lib.mjs');
+await initI18n(argv.language);
+
 const taskInput = argv['task-input'] || argv.taskInput || argv._[0];
 const selectedModel = argv.model || getDefaultTaskModel(argv.tool);
 const modelValidation = validateModelName(selectedModel, argv.tool);

package/src/telegram-bot.mjs

@@ -297,6 +297,12 @@ await initializeSentry({
   environment: process.env.NODE_ENV || 'production',
 });
 
+// Initialize i18n: pre-load every supported locale so per-user translations
+// can resolve synchronously from the cache when handling Telegram updates.
+const { initI18n, t, preloadAllLocales, resolveLocaleFromTelegramCtx } = await import('./i18n.lib.mjs');
+await initI18n();
+await preloadAllLocales();
+
 const telegrafModule = await use('telegraf');
 const { Telegraf } = telegrafModule;
 
@@ -564,6 +570,7 @@ bot.command('help', async ctx => {
   message += '`/solve_queue` - Show solve queue status\n';
   message += '*/limits* - Show usage limits\n';
   message += '*/version* - Show bot and runtime versions\n';
+  message += '*/language* `[en|ru|zh|hi]` - Set or show your preferred reply language (in-memory only, per-user)\n';
   message += '`/accept_invites` - Accept all pending GitHub invitations\n';
   message += '*/merge* - Merge queue (experimental)\n';
   message += 'Usage: `/merge <github-repo-url>`\n';
@@ -621,11 +628,12 @@ bot.command('limits', async ctx => {
     return;
   }
 
+  const userLocale = resolveLocaleFromTelegramCtx(ctx);
   if (!_isGroupChat(ctx)) {
     if (VERBOSE) {
       console.log('[VERBOSE] /limits ignored: not a group chat');
     }
-    await ctx.reply('❌ The /limits command only works in group chats. Please add this bot to a group and make it an admin.', { reply_to_message_id: ctx.message.message_id });
+    await ctx.reply(t('telegram.limits_only_in_groups', {}, { locale: userLocale }), { reply_to_message_id: ctx.message.message_id });
     return;
   }
 
@@ -638,7 +646,7 @@ bot.command('limits', async ctx => {
   }
 
   // Send "fetching" message to indicate work is in progress
-  const fetchingMessage = await ctx.reply('🔄 Fetching usage limits...', {
+  const fetchingMessage = await ctx.reply(t('telegram.fetching_limits', {}, { locale: userLocale }), {
     reply_to_message_id: ctx.message.message_id,
   });
 
@@ -651,7 +659,7 @@ bot.command('limits', async ctx => {
   const solveQueue = getSolveQueue({ verbose: VERBOSE });
   const queueStatus = await solveQueue.formatStatus();
   const codexSection = formatCodexLimitsSection(limits.codex.success ? limits.codex : null, codexError);
-  const message = '📊 *Usage Limits*\n\n' + formatUsageMessage(limits.claude.success ? limits.claude.usage : null, limits.disk.success ? limits.disk.diskSpace : null, limits.github.success ? limits.github.githubRateLimit : null, limits.cpu.success ? limits.cpu.cpuLoad : null, limits.memory.success ? limits.memory.memory : null, claudeError, [codexSection, queueStatus]);
+  const message = t('telegram.usage_limits_title', {}, { locale: userLocale }) + '\n\n' + formatUsageMessage(limits.claude.success ? limits.claude.usage : null, limits.disk.success ? limits.disk.diskSpace : null, limits.github.success ? limits.github.githubRateLimit : null, limits.cpu.success ? limits.cpu.cpuLoad : null, limits.memory.success ? limits.memory.memory : null, claudeError, [codexSection, queueStatus]);
   await ctx.telegram.editMessageText(fetchingMessage.chat.id, fetchingMessage.message_id, undefined, message, { parse_mode: 'Markdown' });
 });
 bot.command('version', async ctx => {
@@ -663,16 +671,20 @@ bot.command('version', async ctx => {
     data: { chatId: ctx.chat?.id, chatType: ctx.chat?.type, userId: ctx.from?.id, username: ctx.from?.username },
   });
   if (isOldMessage(ctx) || isForwardedOrReply(ctx)) return;
-  if (!_isGroupChat(ctx)) return await ctx.reply('❌ The /version command only works in group chats. Please add this bot to a group and make it an admin.', { reply_to_message_id: ctx.message.message_id });
+  const versionLocale = resolveLocaleFromTelegramCtx(ctx);
+  if (!_isGroupChat(ctx)) return await ctx.reply(t('telegram.version_only_in_groups', {}, { locale: versionLocale }), { reply_to_message_id: ctx.message.message_id });
   if (!isTopicAuthorized(ctx)) return await ctx.reply(buildAuthErrorMessage(ctx), { reply_to_message_id: ctx.message.message_id });
-  const fetchingMessage = await ctx.reply('🔄 Gathering version information...', {
+  const fetchingMessage = await ctx.reply(t('telegram.gathering_version', {}, { locale: versionLocale }), {
     reply_to_message_id: ctx.message.message_id,
   });
   const result = await getVersionInfo(VERBOSE);
   if (!result.success) return await ctx.telegram.editMessageText(fetchingMessage.chat.id, fetchingMessage.message_id, undefined, `❌ ${escapeMarkdownV2(result.error, { preserveCodeBlocks: true })}`, { parse_mode: 'MarkdownV2' });
-  await ctx.telegram.editMessageText(fetchingMessage.chat.id, fetchingMessage.message_id, undefined, '🤖 *Version Information*\n\n' + formatVersionMessage(result.versions), { parse_mode: 'Markdown' });
+  await ctx.telegram.editMessageText(fetchingMessage.chat.id, fetchingMessage.message_id, undefined, t('telegram.version_information_title', {}, { locale: versionLocale }) + '\n\n' + formatVersionMessage(result.versions), { parse_mode: 'Markdown' });
 });
 
+const { registerLanguageCommand } = await import('./telegram-language-command.lib.mjs');
+registerLanguageCommand(bot, { VERBOSE, isOldMessage, isForwardedOrReply });
+
 const { registerAcceptInvitesCommand } = await import('./telegram-accept-invitations.lib.mjs');
 const sharedCommandOpts = { VERBOSE, isOldMessage, isForwardedOrReply, isGroupChat: _isGroupChat, isChatAuthorized, isTopicAuthorized, buildAuthErrorMessage, addBreadcrumb, isChatStopped, getStoppedChatRejectMessage };
 registerAcceptInvitesCommand(bot, sharedCommandOpts);
@@ -704,11 +716,12 @@ async function handleSolveCommand(ctx) {
     },
   });
 
+  const solveLocale = resolveLocaleFromTelegramCtx(ctx);
   if (!solveEnabled) {
     if (VERBOSE) {
       console.log(`[VERBOSE] ${solveCommandDisplay} ignored: command disabled`);
     }
-    await ctx.reply('❌ The solve command is disabled on this bot instance.');
+    await ctx.reply(t('telegram.solve_disabled', {}, { locale: solveLocale }));
     return;
   }
 
@@ -737,7 +750,7 @@ async function handleSolveCommand(ctx) {
     if (VERBOSE) {
       console.log(`[VERBOSE] ${solveCommandDisplay} ignored: not a group chat`);
     }
-    await ctx.reply(`❌ The ${solveCommandDisplay} command only works in group chats. Please add this bot to a group and make it an admin.`, { reply_to_message_id: ctx.message.message_id });
+    await ctx.reply(t('telegram.solve_only_in_groups', { commandDisplay: solveCommandDisplay }, { locale: solveLocale }), { reply_to_message_id: ctx.message.message_id });
     return;
   }
 
@@ -802,7 +815,7 @@ async function handleSolveCommand(ctx) {
       if (VERBOSE) {
         console.log('[VERBOSE] No GitHub URL found in replied message');
       }
-      await safeReply(ctx, '❌ No GitHub issue/PR link found in the replied message.\n\nExample: Reply to a message containing a GitHub issue link with `/solve`\n\nOr with options: `/solve --model opus`', { reply_to_message_id: ctx.message.message_id });
+      await safeReply(ctx, t('telegram.no_github_link_in_reply', {}, { locale: solveLocale }), { reply_to_message_id: ctx.message.message_id });
       return;
     }
   }
@@ -811,7 +824,7 @@ async function handleSolveCommand(ctx) {
 
   const { malformed, errors: malformedErrors } = detectMalformedFlags(userArgs);
   if (malformed.length > 0) {
-    await safeReply(ctx, `❌ ${escapeMarkdown(malformedErrors.join('\n'))}\n\nPlease check your option syntax.`, { reply_to_message_id: ctx.message.message_id });
+    await safeReply(ctx, `❌ ${escapeMarkdown(malformedErrors.join('\n'))}\n\n${t('telegram.option_syntax_check', {}, { locale: solveLocale })}`, { reply_to_message_id: ctx.message.message_id });
     return;
   }
 
@@ -828,13 +841,13 @@ async function handleSolveCommand(ctx) {
   userArgs = moveArgumentToFront(userArgs, validation.normalizedUrl, cleanNonPrintableChars);
   const { backend: solvePerCommandIsolation, filteredArgs: userArgsWithoutIsolation } = extractIsolationFromArgs(userArgs); // issue #1534
   if (solvePerCommandIsolation && !isValidPerCommandIsolation(solvePerCommandIsolation)) {
-    await safeReply(ctx, `❌ Invalid --isolation value '${escapeMarkdown(solvePerCommandIsolation)}'. Must be: screen, tmux, or docker`, { reply_to_message_id: ctx.message.message_id });
+    await safeReply(ctx, t('telegram.invalid_isolation', { value: escapeMarkdown(solvePerCommandIsolation) }, { locale: solveLocale }), { reply_to_message_id: ctx.message.message_id });
     return;
   }
   const mergedSolveArgs = mergeArgsWithOverrides(userArgsWithoutIsolation, solveOverrides);
   const { backend: solveOverrideIsolation, filteredArgs: args } = extractIsolationFromArgs(mergedSolveArgs);
   if (solveOverrideIsolation && !isValidPerCommandIsolation(solveOverrideIsolation)) {
-    await safeReply(ctx, `❌ Invalid locked --isolation value '${escapeMarkdown(solveOverrideIsolation)}'. Must be: screen, tmux, or docker`, { reply_to_message_id: ctx.message.message_id });
+    await safeReply(ctx, t('telegram.invalid_locked_isolation', { value: escapeMarkdown(solveOverrideIsolation) }, { locale: solveLocale }), { reply_to_message_id: ctx.message.message_id });
     return;
   }
   const effectiveSolveIsolation = solveOverrideIsolation || solvePerCommandIsolation;
@@ -863,7 +876,7 @@ async function handleSolveCommand(ctx) {
   }
   const { malformed: mergedMalformed, errors: mergedMalformedErrors } = detectMalformedFlags(args);
   if (mergedMalformed.length > 0) {
-    await safeReply(ctx, `❌ ${escapeMarkdown(mergedMalformedErrors.join('\n'))}\n\nPlease check your option syntax.`, { reply_to_message_id: ctx.message.message_id });
+    await safeReply(ctx, `❌ ${escapeMarkdown(mergedMalformedErrors.join('\n'))}\n\n${t('telegram.option_syntax_check', {}, { locale: solveLocale })}`, { reply_to_message_id: ctx.message.message_id });
     return;
   }
   // Validate merged arguments using solve's yargs config
@@ -871,7 +884,7 @@ async function handleSolveCommand(ctx) {
   try {
     parsedSolveArgs = await parseArgsWithYargs(args, yargs, createSolveYargsConfig);
   } catch (error) {
-    await safeReply(ctx, `❌ Invalid options: ${escapeMarkdown(error.message || String(error))}\n\nUse /help to see available options`, {
+    await safeReply(ctx, t('telegram.invalid_options', { message: escapeMarkdown(error.message || String(error)) }, { locale: solveLocale }), {
       reply_to_message_id: ctx.message.message_id,
     });
     return;
@@ -909,20 +922,20 @@ async function handleSolveCommand(ctx) {
   const existingItem = solveQueue.findByUrl(normalizedUrl);
   if (existingItem) {
     const statusText = existingItem.status === 'starting' || existingItem.status === 'started' ? 'being processed' : 'already in the queue';
-    await safeReply(ctx, `❌ This URL is ${statusText}.\n\nURL: ${escapeMarkdown(normalizedUrl)}\nStatus: ${existingItem.status}\n\n💡 Use /solve_queue to check the queue status.`, { reply_to_message_id: ctx.message.message_id });
+    await safeReply(ctx, t('telegram.url_status_active', { statusText, url: escapeMarkdown(normalizedUrl), status: existingItem.status }, { locale: solveLocale }), { reply_to_message_id: ctx.message.message_id });
     return;
   }
   // Issue #1567: Prevent concurrent sessions on the same PR/issue
   const activeSession = await hasActiveSessionForUrlAsync(normalizedUrl, VERBOSE);
   if (activeSession.isActive) {
-    await safeReply(ctx, `❌ A working session is already running for this URL.\n\nURL: ${escapeMarkdown(normalizedUrl)}\nSession: \`${activeSession.sessionName}\`\n\n💡 Wait for the current session to complete, or use /solve\\_stop to cancel it.`, { reply_to_message_id: ctx.message.message_id });
+    await safeReply(ctx, t('telegram.url_session_running', { url: escapeMarkdown(normalizedUrl), session: activeSession.sessionName }, { locale: solveLocale }), { reply_to_message_id: ctx.message.message_id });
     return;
   }
   const check = await solveQueue.canStartCommand({ tool: solveTool }); // Skip Claude limits for agent (#1159)
   const queueStats = solveQueue.getStats();
   // Handle rejection: threshold strategy is 'reject' — fail immediately (issue #1267)
   if (check.rejected) {
-    await safeReply(ctx, `❌ Solve command rejected.\n\n${infoBlock}\n\n🚫 Reason: ${escapeMarkdown(check.rejectReason || 'Unknown')}`, { reply_to_message_id: ctx.message.message_id });
+    await safeReply(ctx, t('telegram.solve_rejected', { infoBlock, reason: escapeMarkdown(check.rejectReason || 'Unknown') }, { locale: solveLocale }), { reply_to_message_id: ctx.message.message_id });
     return;
   }
 
@@ -970,11 +983,12 @@ async function handleHiveCommand(ctx) {
     },
   });
 
+  const hiveLocale = resolveLocaleFromTelegramCtx(ctx);
   if (!hiveEnabled) {
     if (VERBOSE) {
       console.log('[VERBOSE] /hive ignored: command disabled');
     }
-    await ctx.reply('❌ The /hive command is disabled on this bot instance.');
+    await ctx.reply(t('telegram.hive_disabled', {}, { locale: hiveLocale }));
     return;
   }
 
@@ -998,7 +1012,7 @@ async function handleHiveCommand(ctx) {
     if (VERBOSE) {
       console.log('[VERBOSE] /hive ignored: not a group chat');
     }
-    await ctx.reply('❌ The /hive command only works in group chats. Please add this bot to a group and make it an admin.', { reply_to_message_id: ctx.message.message_id });
+    await ctx.reply(t('telegram.hive_only_in_groups', {}, { locale: hiveLocale }), { reply_to_message_id: ctx.message.message_id });
     return;
   }
 
@@ -1041,13 +1055,13 @@ async function handleHiveCommand(ctx) {
 
   const { backend: hivePerCommandIsolation, filteredArgs: normalizedArgsWithoutIsolation } = extractIsolationFromArgs(normalizedArgs); // issue #1534
   if (hivePerCommandIsolation && !isValidPerCommandIsolation(hivePerCommandIsolation)) {
-    await safeReply(ctx, `❌ Invalid --isolation value '${escapeMarkdown(hivePerCommandIsolation)}'. Must be: screen, tmux, or docker`, { reply_to_message_id: ctx.message.message_id });
+    await safeReply(ctx, t('telegram.invalid_isolation', { value: escapeMarkdown(hivePerCommandIsolation) }, { locale: hiveLocale }), { reply_to_message_id: ctx.message.message_id });
     return;
   }
   const mergedHiveArgs = mergeArgsWithOverrides(normalizedArgsWithoutIsolation, hiveOverrides);
   const { backend: hiveOverrideIsolation, filteredArgs: args } = extractIsolationFromArgs(mergedHiveArgs);
   if (hiveOverrideIsolation && !isValidPerCommandIsolation(hiveOverrideIsolation)) {
-    await safeReply(ctx, `❌ Invalid locked --isolation value '${escapeMarkdown(hiveOverrideIsolation)}'. Must be: screen, tmux, or docker`, { reply_to_message_id: ctx.message.message_id });
+    await safeReply(ctx, t('telegram.invalid_locked_isolation', { value: escapeMarkdown(hiveOverrideIsolation) }, { locale: hiveLocale }), { reply_to_message_id: ctx.message.message_id });
     return;
   }
   const effectiveHiveIsolation = hiveOverrideIsolation || hivePerCommandIsolation;

package/src/telegram-language-command.lib.mjs

@@ -0,0 +1,49 @@
+/**
+ * Telegram /language command implementation.
+ *
+ * Allows each user to override the bot's reply language for the current
+ * process. The override is in-memory only (resets when the bot restarts).
+ *
+ * Usage in chat:
+ *   /language               -> show current language
+ *   /language <en|ru|zh|hi> -> set language for this user
+ *   /language default       -> clear the override (reset|clear also work)
+ */
+
+import { t, getSupportedLocales, normalizeLocale, setUserLocale, clearUserLocale, resolveLocaleFromTelegramCtx } from './i18n.lib.mjs';
+
+export function registerLanguageCommand(bot, options = {}) {
+  const { VERBOSE = false, isOldMessage, isForwardedOrReply } = options;
+
+  bot.command('language', async ctx => {
+    VERBOSE && console.log('[VERBOSE] /language command received');
+    if (isOldMessage?.(ctx) || isForwardedOrReply?.(ctx)) return;
+    const userId = ctx.from?.id;
+    const locale = resolveLocaleFromTelegramCtx(ctx);
+    const supported = getSupportedLocales();
+    const supportedList = supported.join(', ');
+    const text = ctx.message?.text || '';
+    const parts = text.trim().split(/\s+/);
+    const arg = parts.length > 1 ? parts[1] : null;
+    if (!arg) {
+      const langName = t(`language.${locale}`, {}, { locale });
+      await ctx.reply(t('telegram.language_current', { language: langName, supported: supportedList }, { locale }), { parse_mode: 'Markdown', reply_to_message_id: ctx.message.message_id });
+      return;
+    }
+    if (['default', 'reset', 'clear'].includes(arg.toLowerCase())) {
+      clearUserLocale(userId);
+      const newLocale = resolveLocaleFromTelegramCtx(ctx);
+      const langName = t(`language.${newLocale}`, {}, { locale: newLocale });
+      await ctx.reply(t('telegram.language_set', { language: langName }, { locale: newLocale }), { parse_mode: 'Markdown', reply_to_message_id: ctx.message.message_id });
+      return;
+    }
+    const target = normalizeLocale(arg);
+    if (!target) {
+      await ctx.reply(t('telegram.language_invalid', { supported: supportedList }, { locale }), { reply_to_message_id: ctx.message.message_id });
+      return;
+    }
+    setUserLocale(userId, target);
+    const langName = t(`language.${target}`, {}, { locale: target });
+    await ctx.reply(t('telegram.language_set', { language: langName }, { locale: target }), { parse_mode: 'Markdown', reply_to_message_id: ctx.message.message_id });
+  });
+}