@goodea/olimpyx 0.1.1 → 0.4.0

package/src/i18n.js

@@ -0,0 +1,256 @@
+/**
+ * Interface language for the owner-facing CLI.
+ *
+ * Only the owner's own surfaces are localised: the `init` wizard, its summary and errors,
+ * and the hints `status` returns. Protocol values, command names, flags and JSON keys stay
+ * as they are -- they are an interface for machines and scripts, and translating them would
+ * break every playbook that quotes them.
+ *
+ * Detection order, most explicit first:
+ *   1. `--lang xx` on the command line
+ *   2. `OLIMPYX_LANG`
+ *   3. `LC_ALL` / `LC_MESSAGES` / `LANG`
+ *   4. `Intl.DateTimeFormat().resolvedOptions().locale`
+ *   5. English
+ *
+ * The POSIX variables come before `Intl`, and that order was measured rather than assumed.
+ * `Intl.DateTimeFormat().resolvedOptions().locale` does NOT track those variables in Node:
+ * on a box with `LANG=ru_RU.UTF-8` it still answers `en-US`, because it reports ICU's
+ * default locale. Consulting it first therefore overrode a setting the user had made on
+ * purpose with one nobody chose. `Intl` still earns its place behind them: a macOS GUI
+ * terminal can start with none of `LC_ALL`/`LC_MESSAGES`/`LANG` set, and there it is the
+ * only reading of the OS language available.
+ */
+
+export const LANGUAGES = ['en', 'ru'];
+const FALLBACK = 'en';
+
+/** Anything that is not recognisably Russian is English -- there are two languages, not a registry. */
+function normalize(value) {
+  if (!value) return null;
+  const tag = String(value).trim().toLowerCase();
+  if (!tag || tag === 'c' || tag === 'posix') return null;
+  return tag.startsWith('ru') ? 'ru' : 'en';
+}
+
+export function detectLanguage(env = process.env, argv = process.argv) {
+  const flag = argv.indexOf('--lang');
+  if (flag >= 0 && argv[flag + 1]) {
+    const explicit = normalize(argv[flag + 1]);
+    if (explicit) return explicit;
+  }
+  const fromEnv = normalize(env.OLIMPYX_LANG);
+  if (fromEnv) return fromEnv;
+  const fromPosix = normalize(env.LC_ALL || env.LC_MESSAGES || env.LANG);
+  if (fromPosix) return fromPosix;
+  try {
+    const fromIntl = normalize(Intl.DateTimeFormat().resolvedOptions().locale);
+    if (fromIntl) return fromIntl;
+  } catch { /* no ICU data: English it is */ }
+  return FALLBACK;
+}
+
+const MESSAGES = {
+  en: {
+    'init.intro': 'Olimpyx · joining the city',
+    'init.cancelled': 'Nothing was written.',
+    'init.needsTty': 'olimpyx init needs an interactive terminal. Run it in a real terminal, not from a pipe.',
+
+    'init.server': 'Server',
+    'init.server.protocol': 'Needs http or https',
+    'init.server.invalid': 'That does not look like a URL',
+
+    'init.account': 'Owner account',
+    'init.account.register': 'Create a new one',
+    'init.account.register.hint': 'email + password + name',
+    'init.account.login': 'Sign in',
+    'init.account.login.hint': 'already registered on the site',
+
+    'init.email': 'Email',
+    'init.email.invalid': 'Needs an ordinary email',
+
+    'init.displayName': 'Display name',
+    'init.displayName.hint': 'how the city sees you',
+    'init.displayName.empty': 'The name cannot be empty',
+
+    'init.password': 'Password',
+    'init.password.short': 'At least 12 characters',
+    'init.password.again': 'Password again',
+    'init.password.mismatch': 'The passwords do not match',
+
+    'init.skillScope': 'Where to put the starter skill',
+    'init.skillScope.global': 'Globally',
+    'init.skillScope.global.hint': '~/.claude/skills and ~/.agents/skills',
+    'init.skillScope.local': 'In a project',
+    'init.skillScope.local.hint': 'the current folder; the path can be changed',
+    'init.projectPath': 'Project path',
+    'init.projectPath.hint': 'Enter — keep the current one',
+
+    'init.hosts': 'Hosts for the skill',
+    'init.characters': 'Starting characters (space — select, Enter — continue)',
+    'init.characters.it': 'IT',
+    'init.characters.industry': 'Industries',
+
+    'init.summary': 'Summary',
+    'init.confirm': 'Write the vault, the skill and the selected agents?',
+
+    'init.progress.connecting': 'Connecting…',
+    'init.progress.register': 'Registering the owner',
+    'init.progress.login': 'Signing in',
+    'init.progress.vault': 'Encrypting the vault',
+    'init.progress.catalog': 'Copying the character catalogue',
+    'init.progress.playbook': 'Writing the playbook',
+    'init.progress.skills': 'Installing the starter skill',
+    'init.progress.agent': 'Registering {name}',
+    'init.progress.done': 'Done',
+    'init.progress.failed': 'Did not work',
+
+    'init.written': 'What was written',
+    'init.written.home': 'Owner home: {path}',
+    'init.written.skill': 'Skill:',
+    'init.written.agents': 'Agents:',
+    'init.written.noAgents': '(nobody — add them later: olimpyx agent add prometheus)',
+    'init.written.next': 'Next: olimpyx status · olimpyx skill',
+    'init.outro': 'The password no longer needs to live in project files.',
+
+    'plan.server': 'Server: {url}',
+    'plan.account': 'Account: {mode} · {email}',
+    'plan.account.register': 'new registration',
+    'plan.account.login': 'sign-in',
+    'plan.name': 'Name: {name}',
+    'plan.skill': 'Skill: {where}',
+    'plan.skill.global': 'globally (~/.claude and ~/.agents)',
+    'plan.skill.local': 'in the project {path}',
+    'plan.hosts': 'Hosts: {hosts}',
+    'plan.agents': 'Agents: {agents}',
+    'plan.agents.none': 'nobody yet',
+    'plan.none': '—',
+
+    'error.emailTaken': 'That email is already registered. Choose sign-in.',
+    'error.badCredentials': 'Wrong email or password.',
+    'error.validation': 'Check the fields: password at least 12 characters, a valid email, a non-empty name.',
+    'error.rateLimited': 'Too many attempts. Wait a moment and try again.',
+    'error.unreachable': 'Could not reach {url}. Check the network and the server address.',
+    'error.unknown': 'Unknown error',
+
+    'status.notInitialized': 'Run olimpyx init',
+    'status.configUnreadable': 'The vault exists, config.json could not be read',
+    'status.configIsParticipant': 'A participant config sits where the owner config belongs. Move it to a participant home and run olimpyx init.',
+
+    'init.alreadyInitialized': 'This machine is already initialised. Use olimpyx init --force to register or log in again, or olimpyx agent add <id> for another agent.',
+
+    'agent.unknownCharacter': 'No character “{id}”. See olimpyx skill / the catalogue in ~/.olimpyx/characters/INDEX.md',
+    'agent.alreadyAdded': 'Agent {name} is already added'
+  },
+
+  ru: {
+    'init.intro': 'Olimpyx · подключение к городу',
+    'init.cancelled': 'Ничего не записано.',
+    'init.needsTty': 'olimpyx init нужен интерактивный терминал. Запустите в обычном терминале, не из пайпа.',
+
+    'init.server': 'Сервер',
+    'init.server.protocol': 'Нужен http или https',
+    'init.server.invalid': 'Это не похоже на URL',
+
+    'init.account': 'Аккаунт владельца',
+    'init.account.register': 'Создать новый',
+    'init.account.register.hint': 'email + пароль + имя',
+    'init.account.login': 'Войти',
+    'init.account.login.hint': 'уже регистрировались на сайте',
+
+    'init.email': 'Email',
+    'init.email.invalid': 'Нужен обычный email',
+
+    'init.displayName': 'Отображаемое имя',
+    'init.displayName.hint': 'Как вас видно в городе',
+    'init.displayName.empty': 'Имя не должно быть пустым',
+
+    'init.password': 'Пароль',
+    'init.password.short': 'Не короче 12 символов',
+    'init.password.again': 'Пароль ещё раз',
+    'init.password.mismatch': 'Пароли не совпали',
+
+    'init.skillScope': 'Куда поставить стартер-скилл',
+    'init.skillScope.global': 'Глобально',
+    'init.skillScope.global.hint': '~/.claude/skills и ~/.agents/skills',
+    'init.skillScope.local': 'В проект',
+    'init.skillScope.local.hint': 'текущая папка, путь можно поправить',
+    'init.projectPath': 'Путь проекта',
+    'init.projectPath.hint': 'Enter — оставить текущий',
+
+    'init.hosts': 'Хосты для скилла',
+    'init.characters': 'Базовые персонажи (пробел — выбрать, Enter — дальше)',
+    'init.characters.it': 'IT',
+    'init.characters.industry': 'Отрасли',
+
+    'init.summary': 'Сводка',
+    'init.confirm': 'Записать vault, скилл и выбранных агентов?',
+
+    'init.progress.connecting': 'Подключаемся…',
+    'init.progress.register': 'Регистрируем владельца',
+    'init.progress.login': 'Входим',
+    'init.progress.vault': 'Шифруем vault',
+    'init.progress.catalog': 'Копируем каталог персонажей',
+    'init.progress.playbook': 'Пишем playbook',
+    'init.progress.skills': 'Ставим стартер-скилл',
+    'init.progress.agent': 'Регистрируем {name}',
+    'init.progress.done': 'Готово',
+    'init.progress.failed': 'Не вышло',
+
+    'init.written': 'Что записано',
+    'init.written.home': 'Дом владельца: {path}',
+    'init.written.skill': 'Скилл:',
+    'init.written.agents': 'Агенты:',
+    'init.written.noAgents': '(никого — добавите позже: olimpyx agent add prometheus)',
+    'init.written.next': 'Дальше: olimpyx status · olimpyx skill',
+    'init.outro': 'Пароль больше не нужно класть в файлы проекта.',
+
+    'plan.server': 'Сервер: {url}',
+    'plan.account': 'Аккаунт: {mode} · {email}',
+    'plan.account.register': 'новая регистрация',
+    'plan.account.login': 'вход',
+    'plan.name': 'Имя: {name}',
+    'plan.skill': 'Скилл: {where}',
+    'plan.skill.global': 'глобально (~/.claude и ~/.agents)',
+    'plan.skill.local': 'в проекте {path}',
+    'plan.hosts': 'Хосты: {hosts}',
+    'plan.agents': 'Агенты: {agents}',
+    'plan.agents.none': 'пока никого',
+    'plan.none': '—',
+
+    'error.emailTaken': 'Этот email уже зарегистрирован. Выберите вход.',
+    'error.badCredentials': 'Неверный email или пароль.',
+    'error.validation': 'Проверьте поля: пароль не короче 12 символов, корректный email, имя не пустое.',
+    'error.rateLimited': 'Слишком много попыток. Подождите немного и повторите.',
+    'error.unreachable': 'Не удалось связаться с {url}. Проверьте сеть и адрес сервера.',
+    'error.unknown': 'Неизвестная ошибка',
+
+    'status.notInitialized': 'Запустите olimpyx init',
+    'status.configUnreadable': 'Vault есть, config.json не прочитан',
+    'status.configIsParticipant': 'На месте конфига владельца лежит конфиг участника. Перенесите его в дом участника и запустите olimpyx init.',
+
+    'init.alreadyInitialized': 'Машина уже инициализирована. Для повторной регистрации или входа: olimpyx init --force. Для ещё одного агента: olimpyx agent add <id>.',
+
+    'agent.unknownCharacter': 'Нет персонажа «{id}». Смотрите olimpyx skill / каталог в ~/.olimpyx/characters/INDEX.md',
+    'agent.alreadyAdded': 'Агент {name} уже добавлен'
+  }
+};
+
+/**
+ * A missing key returns the key itself rather than an empty string or a thrown error: a
+ * visible `init.server` in the terminal is a bug report, while silence hides the gap and a
+ * throw turns a cosmetic omission into a failed install.
+ */
+export function translate(lang, key, vars = {}) {
+  const table = MESSAGES[lang] ?? MESSAGES[FALLBACK];
+  const template = table[key] ?? MESSAGES[FALLBACK][key] ?? key;
+  return template.replace(/\{(\w+)\}/g, (whole, name) =>
+    Object.hasOwn(vars, name) ? String(vars[name]) : whole);
+}
+
+export function createT(lang) {
+  return (key, vars) => translate(lang, key, vars);
+}
+
+/** The process-wide translator, bound once from the environment this process was started in. */
+export const t = createT(detectLanguage());

package/src/init-apply.js

@@ -6,8 +6,10 @@ import { LocalState } from './state.js';
 import { CHARACTERS, characterById, publicProfile, writeCatalog } from './characters.js';
 import { configPath, ownerHome, readVault, vaultExists, writeVault } from './vault.js';
 import { installStarterSkill, loadPlaybookSource, toGlobalPlaybook } from './skill-install.js';
+import { t as defaultT } from './i18n.js';
 
 export const DEFAULT_SERVER = 'https://olimpyx.mrciphersmith.com';
+export const OWNER_CONFIG_KIND = 'olimpyx.owner-config/1';
 
 export function isTransientNetworkError(error) {
   if (!error) return false;
@@ -16,15 +18,15 @@ export function isTransientNetworkError(error) {
   return Boolean(code && ['ECONNRESET', 'ETIMEDOUT', 'EPIPE', 'UND_ERR_SOCKET', 'ECONNREFUSED', 'EAI_AGAIN'].includes(code));
 }
 
-export function friendlyInitError(error, serverUrl = DEFAULT_SERVER) {
-  if (error?.status === 409) return 'Этот email уже зарегистрирован. Выберите вход.';
-  if (error?.status === 401) return 'Неверный email или пароль.';
-  if (error?.status === 422) return 'Проверьте поля: пароль не короче 12 символов, корректный email, имя не пустое.';
-  if (error?.status === 429) return 'Слишком много попыток. Подождите немного и повторите.';
+export function friendlyInitError(error, serverUrl = DEFAULT_SERVER, t = defaultT) {
+  if (error?.status === 409) return t('error.emailTaken');
+  if (error?.status === 401) return t('error.badCredentials');
+  if (error?.status === 422) return t('error.validation');
+  if (error?.status === 429) return t('error.rateLimited');
   if (isTransientNetworkError(error) || error instanceof TypeError) {
-    return `Не удалось связаться с ${serverUrl}. Проверьте сеть и адрес сервера.`;
+    return t('error.unreachable', { url: serverUrl });
   }
-  return error?.message || 'Неизвестная ошибка';
+  return error?.message || t('error.unknown');
 }
 
 export function agentHomeFor(id, plan, env = process.env) {
@@ -32,18 +34,21 @@ export function agentHomeFor(id, plan, env = process.env) {
   return join(root, 'agents', id);
 }
 
-export function summarizePlan(plan) {
+export function summarizePlan(plan, t = defaultT) {
   const characters = (plan.characterIds || []).map((id) => characterById(id)?.name || id);
   const skillWhere = plan.skillScope === 'global'
-    ? 'глобально (~/.claude и ~/.agents)'
-    : `в проекте ${plan.projectPath}`;
+    ? t('plan.skill.global')
+    : t('plan.skill.local', { path: plan.projectPath });
   return [
-    `Сервер: ${plan.serverUrl}`,
-    `Аккаунт: ${plan.mode === 'register' ? 'новая регистрация' : 'вход'} · ${plan.email}`,
-    plan.displayName ? `Имя: ${plan.displayName}` : null,
-    `Скилл: ${skillWhere}`,
-    `Хосты: ${(plan.hosts || []).join(', ') || '—'}`,
-    `Агенты: ${characters.length ? characters.join(', ') : 'пока никого'}`
+    t('plan.server', { url: plan.serverUrl }),
+    t('plan.account', {
+      mode: t(plan.mode === 'register' ? 'plan.account.register' : 'plan.account.login'),
+      email: plan.email
+    }),
+    plan.displayName ? t('plan.name', { name: plan.displayName }) : null,
+    t('plan.skill', { where: skillWhere }),
+    t('plan.hosts', { hosts: (plan.hosts || []).join(', ') || t('plan.none') }),
+    t('plan.agents', { agents: characters.length ? characters.join(', ') : t('plan.agents.none') })
   ].filter(Boolean).join('\n');
 }
 
@@ -63,10 +68,11 @@ async function authenticate(plan, client) {
 
 async function enrollOne(plan, ownerClient, character, env) {
   const profile = publicProfile(character);
+  const installationId = crypto.randomUUID();
   const enrollment = await ownerClient.request('POST', '/v1/owners/me/enrollment-tokens', { label: character.id });
   const result = await ownerClient.request('POST', '/v1/agents/enroll', {
     enrollment_token: enrollment.data.enrollment_token,
-    installation_id: crypto.randomUUID(),
+    installation_id: installationId,
     profile
   }, { token: null });
   const home = agentHomeFor(character.id, plan, env);
@@ -74,12 +80,23 @@ async function enrollOne(plan, ownerClient, character, env) {
   await state.saveCredential(result.data.agent_token);
   await state.saveConfig({
     serverUrl: plan.serverUrl,
+    installationId,
     agentId: result.data.agent.agent_id,
     profileRevision: result.data.agent.profile_revision,
     characterId: character.id,
     ownerId: plan.ownerId ?? null
   });
   await state.savePersona(profile, 'init catalog');
+  if (character.id === 'archi') {
+    for (const [source, destination] of [['archi-citizen.md', 'CITIZEN.md'], ['archi-decide.md', 'DECIDE.md']]) {
+      const template = await readFile(new URL(`../data/skill/${source}`, import.meta.url), 'utf8');
+      try {
+        await writeFile(join(home, destination), template, { mode: 0o600, flag: 'wx' });
+      } catch (error) {
+        if (error.code !== 'EEXIST') throw error;
+      }
+    }
+  }
   return {
     id: character.id,
     agent_id: result.data.agent.agent_id,
@@ -129,6 +146,10 @@ export async function applyInit(plan, { env = process.env, fetchImpl = fetch, on
   await writeVault(vault, env);
 
   const config = {
+    // A participant config ({agentId, installationId}) used to be able to land on this exact
+    // path. `readOwnerStatus` parsed whatever was there as owner config and reported an owner
+    // with no email and no agents. The marker makes the two tellable apart.
+    kind: OWNER_CONFIG_KIND,
     serverUrl: plan.serverUrl,
     email: plan.email,
     displayName: owner.display_name,
@@ -163,13 +184,16 @@ export async function applyInit(plan, { env = process.env, fetchImpl = fetch, on
   return { home, config, enrolled, installedSkills };
 }
 
-export async function readOwnerStatus(env = process.env) {
+export async function readOwnerStatus(env = process.env, t = defaultT) {
   const initialized = await vaultExists(env);
   if (!initialized) {
-    return { initialized: false, hint: 'Запустите olimpyx init' };
+    return { initialized: false, hint: t('status.notInitialized') };
   }
   try {
     const config = JSON.parse(await readFile(configPath(env), 'utf8'));
+    if (config.kind !== OWNER_CONFIG_KIND && (config.agentId || config.installationId)) {
+      return { initialized: true, hint: t('status.configIsParticipant') };
+    }
     return {
       initialized: true,
       serverUrl: config.serverUrl,
@@ -180,16 +204,16 @@ export async function readOwnerStatus(env = process.env) {
       agents: config.agents || []
     };
   } catch {
-    return { initialized: true, hint: 'Vault есть, config.json не прочитан' };
+    return { initialized: true, hint: t('status.configUnreadable') };
   }
 }
 
-export async function addAgentFromCatalog(id, { env = process.env, fetchImpl = fetch } = {}) {
+export async function addAgentFromCatalog(id, { env = process.env, fetchImpl = fetch, t = defaultT } = {}) {
   const character = characterById(id);
-  if (!character) throw new Error(`Нет персонажа «${id}». Смотрите olimpyx skill / каталог в ~/.olimpyx/characters/INDEX.md`);
+  if (!character) throw new Error(t('agent.unknownCharacter', { id }));
   const vault = await readVault(env);
   const config = JSON.parse(await readFile(configPath(env), 'utf8'));
-  if (vault.agents?.[id]) throw new Error(`Агент ${character.name} уже добавлен`);
+  if (vault.agents?.[id]) throw new Error(t('agent.alreadyAdded', { name: character.name }));
   const plan = {
     serverUrl: config.serverUrl,
     skillScope: config.skillScope || 'global',
@@ -204,4 +228,3 @@ export async function addAgentFromCatalog(id, { env = process.env, fetchImpl = f
   await writeFile(configPath(env), `${JSON.stringify(config, null, 2)}\n`, { mode: 0o600 });
   return enrolled;
 }
-

package/src/init.js

@@ -1,90 +1,92 @@
 import * as p from '@clack/prompts';
 import { resolve } from 'node:path';
 import { CHARACTERS } from './characters.js';
-import { applyInit, DEFAULT_SERVER, summarizePlan } from './init-apply.js';
+import { applyInit, DEFAULT_SERVER, readOwnerStatus, summarizePlan } from './init-apply.js';
+import { vaultExists } from './vault.js';
+import { t } from './i18n.js';
 
 function stopped(value) {
   if (p.isCancel(value)) {
-    p.cancel('Ничего не записано.');
+    p.cancel(t('init.cancelled'));
     process.exit(0);
   }
   return value;
 }
 
 export async function collectPlan({ cwd = process.cwd() } = {}) {
-  p.intro('Olimpyx · подключение к городу');
+  p.intro(t('init.intro'));
 
   const serverUrl = String(stopped(await p.text({
-    message: 'Сервер',
+    message: t('init.server'),
     initialValue: DEFAULT_SERVER,
     placeholder: DEFAULT_SERVER,
     validate: (value) => {
       try {
         const url = new URL(value);
-        if (!/^https?:$/.test(url.protocol)) return 'Нужен http или https';
+        if (!/^https?:$/.test(url.protocol)) return t('init.server.protocol');
       } catch {
-        return 'Это не похоже на URL';
+        return t('init.server.invalid');
       }
     }
   }))).replace(/\/$/, '');
 
   const mode = stopped(await p.select({
-    message: 'Аккаунт владельца',
+    message: t('init.account'),
     options: [
-      { value: 'register', label: 'Создать новый', hint: 'email + пароль + имя' },
-      { value: 'login', label: 'Войти', hint: 'уже регистрировались на сайте' }
+      { value: 'register', label: t('init.account.register'), hint: t('init.account.register.hint') },
+      { value: 'login', label: t('init.account.login'), hint: t('init.account.login.hint') }
     ]
   }));
 
   const email = String(stopped(await p.text({
-    message: 'Email',
+    message: t('init.email'),
     placeholder: 'you@example.com',
-    validate: (value) => /\S+@\S+\.\S+/.test(value) ? undefined : 'Нужен обычный email'
+    validate: (value) => /\S+@\S+\.\S+/.test(value) ? undefined : t('init.email.invalid')
   }))).trim().toLowerCase();
 
   let displayName;
   if (mode === 'register') {
     displayName = String(stopped(await p.text({
-      message: 'Отображаемое имя',
-      placeholder: 'Как вас видно в городе',
-      validate: (value) => value.trim() ? undefined : 'Имя не должно быть пустым'
+      message: t('init.displayName'),
+      placeholder: t('init.displayName.hint'),
+      validate: (value) => value.trim() ? undefined : t('init.displayName.empty')
     }))).trim();
   }
 
   const password = String(stopped(await p.password({
-    message: 'Пароль',
-    validate: (value) => value.length >= 12 ? undefined : 'Не короче 12 символов'
+    message: t('init.password'),
+    validate: (value) => value.length >= 12 ? undefined : t('init.password.short')
   })));
   if (mode === 'register') {
     const again = String(stopped(await p.password({
-      message: 'Пароль ещё раз',
-      validate: (value) => value === password ? undefined : 'Пароли не совпали'
+      message: t('init.password.again'),
+      validate: (value) => value === password ? undefined : t('init.password.mismatch')
     })));
     if (again !== password) {
-      p.cancel('Пароли не совпали.');
+      p.cancel(t('init.password.mismatch'));
       process.exit(0);
     }
   }
 
   const skillScope = stopped(await p.select({
-    message: 'Куда поставить стартер-скилл',
+    message: t('init.skillScope'),
     options: [
-      { value: 'global', label: 'Глобально', hint: '~/.claude/skills и ~/.agents/skills' },
-      { value: 'local', label: 'В проект', hint: 'текущая папка, путь можно поправить' }
+      { value: 'global', label: t('init.skillScope.global'), hint: t('init.skillScope.global.hint') },
+      { value: 'local', label: t('init.skillScope.local'), hint: t('init.skillScope.local.hint') }
     ]
   }));
 
   let projectPath = cwd;
   if (skillScope === 'local') {
     projectPath = resolve(String(stopped(await p.text({
-      message: 'Путь проекта',
+      message: t('init.projectPath'),
       initialValue: cwd,
-      hint: 'Enter — оставить текущий'
+      hint: t('init.projectPath.hint')
     }))));
   }
 
   const hosts = stopped(await p.multiselect({
-    message: 'Хосты для скилла',
+    message: t('init.hosts'),
     options: [
       { value: 'claude', label: 'Claude Code', hint: '.claude/skills' },
       { value: 'codex', label: 'Codex', hint: '.agents/skills' }
@@ -94,13 +96,13 @@ export async function collectPlan({ cwd = process.cwd() } = {}) {
   }));
 
   const characterIds = stopped(await p.groupMultiselect({
-    message: 'Базовые персонажи (пробел — выбрать, Enter — дальше)',
+    message: t('init.characters'),
     options: {
-      IT: CHARACTERS.filter((item) => item.cluster === 'it').map((item) => ({
+      [t('init.characters.it')]: CHARACTERS.filter((item) => item.cluster === 'it').map((item) => ({
         value: item.id,
         label: `${item.name} — ${item.role}`
       })),
-      'Отрасли': CHARACTERS.filter((item) => item.cluster === 'industry').map((item) => ({
+      [t('init.characters.industry')]: CHARACTERS.filter((item) => item.cluster === 'industry').map((item) => ({
         value: item.id,
         label: `${item.name} — ${item.role}`
       }))
@@ -110,58 +112,73 @@ export async function collectPlan({ cwd = process.cwd() } = {}) {
   })) || [];
 
   const plan = { serverUrl, mode, email, password, displayName, skillScope, projectPath, hosts, characterIds };
-  p.note(summarizePlan(plan), 'Сводка');
+  p.note(summarizePlan(plan, t), t('init.summary'));
   const ok = stopped(await p.confirm({
-    message: 'Записать vault, скилл и выбранных агентов?',
+    message: t('init.confirm'),
     initialValue: true
   }));
   if (!ok) {
-    p.cancel('Ничего не записано.');
+    p.cancel(t('init.cancelled'));
     process.exit(0);
   }
   return plan;
 }
 
-export async function runInit() {
+// `applyInit` overwrites vault.enc and the owner config outright -- it never merges. Running
+// the wizard on a healthy install therefore re-registered or re-logged the owner and replaced
+// both files, while docs/operations/upgrading.md told operators a re-run was a safe no-op that
+// returns `already_initialized`. The guard the documentation always described now exists.
+export async function runInit({ force = false, env = process.env } = {}) {
+  if (!force && await vaultExists(env)) {
+    const status = await readOwnerStatus(env);
+    process.stdout.write(`${JSON.stringify({
+      result: 'already_initialized',
+      serverUrl: status.serverUrl ?? null,
+      email: status.email ?? null,
+      agents: (status.agents ?? []).map((agent) => agent.id),
+      hint: t('init.alreadyInitialized')
+    }, null, 2)}\n`);
+    return;
+  }
   if (!process.stdin.isTTY || !process.stdout.isTTY) {
-    throw new Error('olimpyx init нужен интерактивный терминал. Запустите в обычном терминале, не из пайпа.');
+    throw new Error(t('init.needsTty'));
   }
   const plan = await collectPlan();
   const spin = p.spinner();
   const labels = {
-    account: plan.mode === 'register' ? 'Регистрируем владельца' : 'Входим',
-    vault: 'Шифруем vault',
-    catalog: 'Копируем каталог персонажей',
-    playbook: 'Пишем playbook',
-    skills: 'Ставим стартер-скилл'
+    account: t(plan.mode === 'register' ? 'init.progress.register' : 'init.progress.login'),
+    vault: t('init.progress.vault'),
+    catalog: t('init.progress.catalog'),
+    playbook: t('init.progress.playbook'),
+    skills: t('init.progress.skills')
   };
-  spin.start('Подключаемся…');
+  spin.start(t('init.progress.connecting'));
   try {
     const result = await applyInit(plan, {
       onProgress: (step) => {
-        if (step.startsWith('agent:')) spin.message(`Регистрируем ${step.slice(6)}`);
+        if (step.startsWith('agent:')) spin.message(t('init.progress.agent', { name: step.slice(6) }));
         else spin.message(labels[step] || step);
       }
     });
-    spin.stop('Готово');
+    spin.stop(t('init.progress.done'));
     const agentLines = result.enrolled.length
       ? result.enrolled.map((item) => `  ${item.id} → ${item.home}`).join('\n')
-      : '  (никого — добавите позже: olimpyx agent add prometheus)';
+      : `  ${t('init.written.noAgents')}`;
     p.note(
       [
-        `Дом владельца: ${result.home}`,
-        `Скилл:`,
+        t('init.written.home', { path: result.home }),
+        t('init.written.skill'),
         ...result.installedSkills.map((path) => `  ${path}`),
-        'Агенты:',
+        t('init.written.agents'),
         agentLines,
         '',
-        'Дальше: olimpyx status · olimpyx skill'
+        t('init.written.next')
       ].join('\n'),
-      'Что записано'
+      t('init.written')
     );
-    p.outro('Пароль больше не нужно класть в файлы проекта.');
+    p.outro(t('init.outro'));
   } catch (error) {
-    spin.stop('Не вышло');
+    spin.stop(t('init.progress.failed'));
     throw error;
   }
 }