orchestrix-yuri 4.8.0 → 4.8.1

package/lib/gateway/engine/claude-sdk.js

@@ -9,6 +9,7 @@ const yaml = require('js-yaml');
 const YURI_GLOBAL = path.join(os.homedir(), '.yuri');
 const SESSION_FILE = path.join(YURI_GLOBAL, 'gateway-session.json');
 const { log } = require('../log');
+const { msg } = require('./messages');
 
 // ── Shared Utilities ───────────────────────────────────────────────────────────
 
@@ -309,7 +310,7 @@ function runClaude(args, cwd, timeout) {
     }, (err, stdout, stderr) => {
       if (err && err.killed) {
         log.warn('Claude CLI timed out');
-        return resolve({ reply: '⏱ This is taking longer than usual. The operation may still be running.\n\nTry `*status` to check progress, or send your message again.', raw: '' });
+        return resolve({ reply: msg('timeout'), raw: '' });
       }
       // Claude CLI may return non-zero exit code even with valid JSON output
       // (e.g., stderr "Warning: no stdin data received" causes exit code 1).
@@ -317,7 +318,7 @@ function runClaude(args, cwd, timeout) {
       if (err && !stdout.trim()) {
         log.error(`Claude CLI error: ${err.message.slice(0, 200)}`);
         if (stderr) log.info(`stderr: ${stderr.slice(0, 200)}`);
-        return resolve({ reply: '❌ Something went wrong. Try again, or use `*status` to check state.', raw: stderr });
+        return resolve({ reply: msg('cli_error'), raw: stderr });
       }
 
       try {

package/lib/gateway/engine/messages.js

@@ -0,0 +1,169 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+// ── Language Detection ──────────────────────────────────────────────────────
+
+let _cachedLang = null;
+let _langCheckedAt = 0;
+const LANG_CACHE_TTL = 300000; // 5 min
+
+/**
+ * Detect user language from boss/preferences.yaml.
+ * Falls back to 'en'. Caches for 5 min.
+ */
+function detectLang() {
+  const now = Date.now();
+  if (_cachedLang && now - _langCheckedAt < LANG_CACHE_TTL) return _cachedLang;
+
+  _langCheckedAt = now;
+  try {
+    const prefPath = path.join(os.homedir(), '.yuri', 'boss', 'preferences.yaml');
+    if (fs.existsSync(prefPath)) {
+      const content = fs.readFileSync(prefPath, 'utf8');
+      // Quick extraction without yaml dependency (preferences.yaml is simple)
+      const match = content.match(/language:\s*["']?(\w+)/);
+      if (match && match[1]) {
+        const lang = match[1].toLowerCase();
+        _cachedLang = lang.startsWith('zh') ? 'zh' : 'en';
+        return _cachedLang;
+      }
+    }
+  } catch { /* fallback */ }
+
+  _cachedLang = 'en';
+  return _cachedLang;
+}
+
+/** Override language (useful for testing). */
+function setLang(lang) {
+  _cachedLang = lang;
+  _langCheckedAt = Date.now();
+}
+
+// ── Message Templates ───────────────────────────────────────────────────────
+
+const MESSAGES = {
+  // ── Phase Completion ──
+  plan_complete: {
+    en: '🎉 Planning complete!{summary}\n\nNext: review the docs above, then run `*develop` to start building.',
+    zh: '🎉 规划完成！{summary}\n\n下一步：检查上面的文档，然后运行 `*develop` 开始开发。',
+  },
+  dev_complete: {
+    en: '🎉 Development complete! All stories implemented.\n\nNext: run `*test` to validate each epic with smoke tests.',
+    zh: '🎉 开发完成！所有 story 已实现。\n\n下一步：运行 `*test` 对每个 epic 进行冒烟测试。',
+  },
+  test_all_passed: {
+    en: '\n🚀 All tests passed! Run `*deploy` when ready.',
+    zh: '\n🚀 全部测试通过！准备好后运行 `*deploy` 部署。',
+  },
+  test_some_failed: {
+    en: '\n⚠️ {count} epic(s) failed. Review and fix manually, or run `*test` again.',
+    zh: '\n⚠️ {count} 个 epic 未通过。手动修复后重新运行 `*test`。',
+  },
+  iterate_launched: {
+    en: '🔄 New iteration launched!\n\nSM is drafting new stories. Agents will chain automatically (SM → Architect → Dev → QA).',
+    zh: '🔄 新迭代已启动！\n\nSM 正在拆分新 story，Agent 将自动接力（SM → Architect → Dev → QA）。',
+  },
+
+  // ── Phase Start ──
+  dev_started: {
+    en: '🚀 Development started! 4 agents (Architect, SM, Dev, QA) are running.\n\nAgents chain automatically via handoff-detector. I\'ll send a progress report every {minutes} minutes.',
+    zh: '🚀 开发已启动！4 个 Agent（Architect、SM、Dev、QA）正在工作。\n\nAgent 通过 handoff-detector 自动接力。我每 {minutes} 分钟发送一次进度报告。',
+  },
+
+  // ── Change / Direct Agent ──
+  change_small: {
+    en: '🔧 Small change started → Dev *solo\n\n"{desc}"\n\nI\'ll notify you when it\'s done.',
+    zh: '🔧 小改动已启动 → Dev *solo\n\n"{desc}"\n\n完成后我会通知你。',
+  },
+  change_medium: {
+    en: '🔧 {scope} change started → PO *route-change\n\n"{desc}"\n\nPO will assess and route to the right agent. I\'ll keep you updated.',
+    zh: '🔧 {scope}级改动已启动 → PO *route-change\n\n"{desc}"\n\nPO 评估后分配给合适的 Agent，我会持续更新。',
+  },
+  direct_agent: {
+    en: '🎯 → **{agent}**\n\n"{desc}"\n\nI\'ll notify you when done.',
+    zh: '🎯 → **{agent}**\n\n"{desc}"\n\n完成后通知你。',
+  },
+  quickfix_started: {
+    en: '🐛 Quick fix started → Dev *quick-fix\n\n"{desc}"\n\nI\'ll notify you when it\'s done.',
+    zh: '🐛 快速修复已启动 → Dev *quick-fix\n\n"{desc}"\n\n完成后通知你。',
+  },
+
+  // ── Progress ──
+  agent_handoff: {
+    en: '🔄 {from} → **{to}**{story}',
+    zh: '🔄 {from} → **{to}**{story}',
+  },
+  monitoring_dev: {
+    en: '🔄 Now monitoring dev cycle (SM → Architect → Dev → QA). I\'ll report agent handoffs and progress.',
+    zh: '🔄 正在监控开发流程（SM → Architect → Dev → QA），我会汇报 Agent 交接和进度。',
+  },
+  change_complete: {
+    en: '✅ Change complete.\n\n{summary}\n\nWhat would you like to do next?',
+    zh: '✅ 改动完成。\n\n{summary}\n\n接下来要做什么？',
+  },
+
+  // ── Errors ──
+  error_recovery: {
+    en: {
+      plan:    'Run `*plan` to restart, or `*status` to check saved progress.',
+      develop: 'Run `*develop` to restart, or `*status` to see completed stories.',
+      test:    'Run `*test` to restart testing.',
+      change:  'Send your change request again.',
+      iterate: 'Run `*iterate` again.',
+      default: 'Use `*status` to check current state.',
+    },
+    zh: {
+      plan:    '运行 `*plan` 重新开始，或 `*status` 查看已保存的进度。',
+      develop: '运行 `*develop` 重新开始，或 `*status` 查看已完成的 story。',
+      test:    '运行 `*test` 重新测试。',
+      change:  '重新发送你的改动请求。',
+      iterate: '重新运行 `*iterate`。',
+      default: '使用 `*status` 查看当前状态。',
+    },
+  },
+  timeout: {
+    en: '⏱ This is taking longer than usual. The operation may still be running.\n\nTry `*status` to check progress, or send your message again.',
+    zh: '⏱ 处理时间较长，操作可能仍在进行中。\n\n试试 `*status` 查看进度，或重新发送消息。',
+  },
+  cli_error: {
+    en: '❌ Something went wrong. Try again, or use `*status` to check state.',
+    zh: '❌ 出了点问题。请重试，或使用 `*status` 查看状态。',
+  },
+
+  // ── Status ──
+  no_phase: {
+    en: 'No active phase. Available commands: *plan, *develop, *test, *deploy, *projects, *switch',
+    zh: '当前无活跃阶段。可用命令：*plan、*develop、*test、*deploy、*projects、*switch',
+  },
+};
+
+// ── Public API ──────────────────────────────────────────────────────────────
+
+/**
+ * Get a localized message by key with parameter substitution.
+ * @param {string} key - Message key (e.g., 'plan_complete')
+ * @param {object} params - Substitution params (e.g., { summary: '...' })
+ * @returns {string}
+ */
+function msg(key, params = {}) {
+  const lang = detectLang();
+  const template = MESSAGES[key];
+  if (!template) return key;
+
+  let text = template[lang] || template.en || key;
+
+  // Handle nested objects (like error_recovery)
+  if (typeof text === 'object') {
+    const subKey = params._sub || 'default';
+    text = text[subKey] || text.default || JSON.stringify(text);
+  }
+
+  // Substitute {param} placeholders
+  return text.replace(/\{(\w+)\}/g, (_, k) => (params[k] != null ? params[k] : `{${k}}`));
+}
+
+module.exports = { msg, detectLang, setLang, MESSAGES };

package/lib/gateway/engine/phase-orchestrator.js

@@ -7,6 +7,7 @@ const os = require('os');
 const yaml = require('js-yaml');
 const tmx = require('./tmux-utils');
 const { log } = require('../log');
+const { msg } = require('./messages');
 
 const YURI_GLOBAL = path.join(os.homedir(), '.yuri');
 const SKILL_DIR = path.join(os.homedir(), '.claude', 'skills', 'yuri');
@@ -550,7 +551,7 @@ class PhaseOrchestrator {
     const outputSummary = outputs.length > 0 ? `\n\n${outputs.join('\n')}` : '';
 
     log.engine('Plan phase complete');
-    this.onComplete('plan', `🎉 Planning complete!${outputSummary}\n\nNext: review the docs above, then run \`*develop\` to start building.`);
+    this.onComplete('plan', msg('plan_complete', { summary: outputSummary }));
   }
 
   /**
@@ -652,7 +653,7 @@ class PhaseOrchestrator {
 
     const reportMin = Math.round(this._reportInterval / 60000);
     log.engine(`Dev phase started: session=${this._session}, report every ${reportMin}min`);
-    return `🚀 Development started! 4 agents (Architect, SM, Dev, QA) are running.\n\nAgents chain automatically via handoff-detector. I'll send a progress report every ${reportMin} minutes.`;
+    return msg('dev_started', { minutes: reportMin });
   }
 
   _pollDevSession() {
@@ -885,7 +886,7 @@ class PhaseOrchestrator {
     }
 
     log.engine('Dev phase complete');
-    this.onComplete('develop', '🎉 Development complete! All stories implemented.\n\nNext: run `*test` to validate each epic with smoke tests.');
+    this.onComplete('develop', msg('dev_complete'));
   }
 
   // ── Test Phase ──────────────────────────────────────────────────────────────
@@ -1322,9 +1323,9 @@ class PhaseOrchestrator {
     }
 
     if (failed === 0) {
-      lines.push('\n🚀 All tests passed! Run *deploy when ready.');
+      lines.push(msg('test_all_passed'));
     } else {
-      lines.push(`\n⚠️ ${failed} epic(s) failed. Review and fix manually, or run *test again.`);
+      lines.push(msg('test_some_failed', { count: failed }));
     }
 
     this._phase = null;
@@ -1442,7 +1443,7 @@ class PhaseOrchestrator {
 
     this._changeContext = null;
     log.engine('Iterate complete — dev automation started');
-    this.onComplete('iterate', `🔄 New iteration launched!\n\nSM is drafting new stories. Agents will chain automatically (SM → Architect → Dev → QA).`);
+    this.onComplete('iterate', msg('iterate_launched'));
 
     // Transition to dev monitoring so SM → Architect → Dev → QA cycle is tracked.
     // Without this, the entire dev cycle runs unmonitored after iterate completes.
@@ -1457,7 +1458,7 @@ class PhaseOrchestrator {
       const pollInterval = this.config.dev_poll_interval || 300000;
       this._timer = setInterval(() => this._pollDevSession(), pollInterval);
       log.engine(`Iterate → dev monitoring: session=${devSession}, poll every ${Math.round(pollInterval / 60000)}min`);
-      this.onProgress('🔄 Now monitoring dev cycle (SM → Architect → Dev → QA). I\'ll report agent handoffs and progress.');
+      this.onProgress(msg('monitoring_dev'));
     } else {
       this._phase = null;
     }
@@ -1511,7 +1512,7 @@ class PhaseOrchestrator {
     this._timer = setInterval(() => this._pollChange(), pollInterval);
 
     log.engine(`Quick fix started: "${bugDesc.slice(0, 60)}..."`);
-    return `🐛 Quick fix started → Dev *quick-fix\n\n"${bugDesc.slice(0, 100)}"\n\nI'll notify you when it's done.`;
+    return msg('quickfix_started', { desc: bugDesc.slice(0, 100) });
   }
 
   // ── Change Management ───────────────────────────────────────────────────────
@@ -1573,7 +1574,7 @@ class PhaseOrchestrator {
     this._changeContext = { scope: 'small', description };
     this._timer = setInterval(() => this._pollChange(), pollInterval);
 
-    return `🔧 Small change started → Dev *solo\n\n"${description.slice(0, 100)}"\n\nI'll notify you when it's done.`;
+    return msg('change_small', { desc: description.slice(0, 100) });
   }
 
   /**
@@ -1603,7 +1604,7 @@ class PhaseOrchestrator {
     };
     this._timer = setInterval(() => this._pollChange(), pollInterval);
 
-    return `🔧 ${scope === 'large' ? 'Large' : 'Medium'} change started → PO *route-change\n\n"${description.slice(0, 100)}"\n\nPO will assess and route to the right agent. I'll keep you updated.`;
+    return msg('change_medium', { scope: scope === 'large' ? 'Large' : 'Medium', desc: description.slice(0, 100) });
   }
 
   /**
@@ -1705,7 +1706,7 @@ class PhaseOrchestrator {
       const pollInterval = this.config.dev_poll_interval || 300000;
       this._timer = setInterval(() => this._pollDevSession(), pollInterval);
       log.engine(`Change → dev monitoring: session=${this._session}, poll every ${Math.round(pollInterval / 60000)}min`);
-      this.onProgress('🔄 Now monitoring dev cycle (SM → Architect → Dev → QA). I\'ll report agent handoffs and progress.');
+      this.onProgress(msg('monitoring_dev'));
     } else {
       this._phase = null;
       this._changeContext = null;
@@ -1730,15 +1731,7 @@ class PhaseOrchestrator {
       .replace(/\/Users\/\S+/g, '')
       .replace(/tmux session/gi, 'agent session');
 
-    const hints = {
-      plan:    'Run `*plan` to restart, or `*status` to check saved progress.',
-      develop: 'Run `*develop` to restart, or `*status` to see completed stories.',
-      test:    'Run `*test` to restart testing.',
-      change:  'Send your change request again.',
-      iterate: 'Run `*iterate` again.',
-    };
-
-    const recovery = hints[phase] || 'Use `*status` to check current state.';
+    const recovery = msg('error_recovery', { _sub: phase });
     this.onError(phase, `❌ ${cleanMsg}\n\n${recovery}`);
   }
 

package/lib/gateway/router.js

@@ -11,6 +11,7 @@ const engine = require('./engine/claude-sdk');
 const { runReflect } = require('./engine/reflect');
 const { PhaseOrchestrator } = require('./engine/phase-orchestrator');
 const { Dispatcher } = require('./engine/dispatcher');
+const { msg } = require('./engine/messages');
 const { log } = require('./log');
 
 const YURI_GLOBAL = path.join(os.homedir(), '.yuri');
@@ -526,7 +527,7 @@ class Router {
       }, pollInterval);
 
       this.history.append(msg.chatId, 'user', msg.text);
-      const reply = `🎯 Direct → **${matched.slug}**\n\n"${cleanDesc.slice(0, 120)}"\n\nI'll notify you when done.`;
+      const reply = msg('direct_agent', { agent: matched.slug, desc: cleanDesc.slice(0, 120) });
       this.history.append(msg.chatId, 'assistant', reply);
       this._updateGlobalFocus(msg, projectRoot);
 
@@ -648,7 +649,7 @@ Reply with ONLY one word: small, medium, or large. Nothing else.`;
     }
 
     if (parts.length === 0) {
-      parts.push('No active phase. Available commands: *plan, *develop, *test, *deploy, *projects, *switch');
+      parts.push(msg('no_phase'));
     }
 
     this.history.append(msg.chatId, 'user', msg.text);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "orchestrix-yuri",
-  "version": "4.8.0",
+  "version": "4.8.1",
   "description": "Yuri — Meta-Orchestrator for Orchestrix. Drive your entire project lifecycle with natural language.",
   "main": "lib/installer.js",
   "bin": {