orchestrix-yuri 4.7.12 → 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: '⏱ Claude is still thinking — your request is being processed. I\'ll follow up when ready. You can also check `*status` for current state.', 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: `❌ Claude CLI error: ${err.message.slice(0, 200)}`, raw: stderr });
+        return resolve({ reply: msg('cli_error'), raw: stderr });
       }
 
       try {
@@ -478,7 +479,7 @@ function composePrompt(userMessage) {
   if (l2) sections.push(l2);
 
   log.engine('Memory context changed, injecting refresh into prompt');
-  return `[CONTEXT UPDATE — Your memory has been updated]\n${sections.join('\n\n')}\n[END CONTEXT UPDATE]\n\n${userMessage}`;
+  return `<system-context-update silent="true">\nDo not mention or reference this context update in your response. This is an automatic memory refresh.\n${sections.join('\n\n')}\n</system-context-update>\n\n${userMessage}`;
 }
 
 /**

package/lib/gateway/engine/dispatcher.js

@@ -67,7 +67,8 @@ class Dispatcher {
   async classify(text) {
     // Re-entry guard
     if (this._busy) {
-      return { action: 'conversation', description: text, reasoning: 'dispatcher busy' };
+      log.warn('Dispatcher: busy, defaulting to change');
+      return { action: 'change', description: text, reasoning: 'dispatcher busy' };
     }
 
     // Auto-recover if session died
@@ -75,7 +76,8 @@ class Dispatcher {
       this._ready = false;
       await this.start();
       if (!this._ready) {
-        return { action: 'conversation', description: text, reasoning: 'dispatcher unavailable' };
+        log.warn('Dispatcher: unavailable after recovery attempt, defaulting to change');
+        return { action: 'change', description: text, reasoning: 'dispatcher unavailable' };
       }
     }
 
@@ -165,17 +167,32 @@ class Dispatcher {
       }
     }
 
-    // Strategy 3: Look for bare action words in the last few lines
-    const tail = lines.slice(-5).join(' ').toLowerCase();
-    for (const action of valid) {
-      if (action !== 'conversation' && tail.includes(`"${action}"`)) {
-        return { action, description: originalText, reasoning: 'keyword match' };
+    // Strategy 3: Claude re-classify (replaces keyword matching)
+    // Only reached when tmux output was garbled or unparseable — rare but important.
+    log.warn('Dispatcher: JSON parse failed, attempting Claude re-classify');
+    try {
+      const engine = require('./claude-sdk');
+      const binary = engine.findClaudeBinary();
+      const safeText = originalText.slice(0, 500).replace(/'/g, "'\\''");
+      const prompt = `Classify this user message into ONE action. Valid actions: ${valid.join(', ')}. Reply with ONLY a JSON object like {"action":"change","description":"summary","reasoning":"why"}. User message: "${safeText}"`;
+      const result = execSync(
+        `${binary} -p '${prompt.replace(/'/g, "'\\''")}' --output-format json 2>/dev/null`,
+        { encoding: 'utf8', timeout: 15000 }
+      ).trim();
+      const json = JSON.parse(result);
+      const reply = json.result || '';
+      const reParsed = JSON.parse(reply);
+      if (reParsed.action && valid.includes(reParsed.action)) {
+        log.engine(`Dispatcher: re-classified as "${reParsed.action}"`);
+        return { action: reParsed.action, description: reParsed.description || originalText, reasoning: 'reclassified' };
       }
+    } catch (err) {
+      log.warn(`Dispatcher: re-classify failed: ${err.message}`);
     }
 
-    // Parse failed — default to "change" (bias toward action, not conversation)
-    log.warn('Dispatcher: failed to parse response, defaulting to change');
-    return { action: 'change', description: originalText, reasoning: 'parse failed' };
+    // Absolute last resort — default to "change" (bias toward action)
+    log.warn('Dispatcher: all strategies failed, defaulting to change');
+    return { action: 'change', description: originalText, reasoning: 'all parse strategies failed' };
   }
 
   /**

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');
@@ -194,7 +195,6 @@ class PhaseOrchestrator {
 
       const waiting = this._waitingForInput ? ' (WAITING FOR YOUR INPUT)' : '';
       return `[LIVE AGENT CONTEXT] Phase: plan, Agent: ${agent.name} (${this._step + 1}/${PLAN_AGENTS.length})${waiting}\n` +
-             `tmux session: ${this._session}, window: ${agent.window}\n` +
              `--- Agent output (last 40 lines) ---\n${pane}\n--- End agent output ---`;
     }
 
@@ -205,9 +205,9 @@ class PhaseOrchestrator {
       for (let w = 0; w < 4; w++) {
         const tail = tmx.capturePane(this._session, w, 5);
         const lastLine = tail.split('\n').filter((l) => l.trim()).pop() || '(empty)';
-        summaries.push(`  Window ${w} (${windows[w]}): ${lastLine.trim().slice(0, 80)}`);
+        summaries.push(`  ${windows[w]}: ${lastLine.trim().slice(0, 80)}`);
       }
-      return `[LIVE AGENT CONTEXT] Phase: develop, Session: ${this._session}\n${summaries.join('\n')}`;
+      return `[LIVE AGENT CONTEXT] Phase: develop\n${summaries.join('\n')}`;
     }
 
     return null;
@@ -539,8 +539,19 @@ class PhaseOrchestrator {
     this._phase = null;
     this._step = 0;
 
+    // Build output summary
+    const outputs = [];
+    for (const agent of PLAN_AGENTS) {
+      if (agent.output) {
+        const outputPath = path.join(this._projectRoot, agent.output);
+        const exists = fs.existsSync(outputPath);
+        outputs.push(`  ${exists ? '✅' : '⚠️'} ${agent.name} → ${agent.output}`);
+      }
+    }
+    const outputSummary = outputs.length > 0 ? `\n\n${outputs.join('\n')}` : '';
+
     log.engine('Plan phase complete');
-    this.onComplete('plan', '🎉 Planning phase complete! All 6 agents finished.\n\nRun *develop to start automated development.');
+    this.onComplete('plan', msg('plan_complete', { summary: outputSummary }));
   }
 
   /**
@@ -642,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() {
@@ -819,7 +830,7 @@ class PhaseOrchestrator {
     // Current activity
     if (p.currentAgent) {
       const storyInfo = p.currentStory ? ` → ${p.currentStory}` : '';
-      lines.push(`Current: ${p.currentAgent} (window ${p.currentWindow})${storyInfo}`);
+      lines.push(`Current: ${p.currentAgent}${storyInfo}`);
     } else {
       lines.push(`Current: waiting for next handoff`);
     }
@@ -875,7 +886,7 @@ class PhaseOrchestrator {
     }
 
     log.engine('Dev phase complete');
-    this.onComplete('develop', '🎉 Development complete! All stories finished.\n\nRun *test to start smoke testing.');
+    this.onComplete('develop', msg('dev_complete'));
   }
 
   // ── Test Phase ──────────────────────────────────────────────────────────────
@@ -1312,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;
@@ -1432,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 stories in dev session: ${devSession}\nAgents will chain automatically via handoff-detector.`);
+    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.
@@ -1447,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;
     }
@@ -1501,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 ───────────────────────────────────────────────────────
@@ -1563,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) });
   }
 
   /**
@@ -1593,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) });
   }
 
   /**
@@ -1695,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;
@@ -1711,7 +1722,17 @@ class PhaseOrchestrator {
     }
     this._phase = null;
     log.error(`Phase ${phase} error: ${message}`);
-    this.onError(phase, message);
+
+    // Sanitize internal details from user-facing message
+    const cleanMsg = message
+      .replace(/orchestrix-[\w-]+/g, 'dev session')
+      .replace(/op-[\w-]+/g, 'planning session')
+      .replace(/yuri-[\w-]+/g, 'dispatcher')
+      .replace(/\/Users\/\S+/g, '')
+      .replace(/tmux session/gi, 'agent session');
+
+    const recovery = msg('error_recovery', { _sub: phase });
+    this.onError(phase, `❌ ${cleanMsg}\n\n${recovery}`);
   }
 
   _updatePlanMemory(status) {

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');
@@ -65,7 +66,7 @@ class Router {
       config: config.engine,
       onProgress: (msg) => this._sendProactive(msg),
       onComplete: (phase, summary) => this._sendProactive(summary),
-      onError: (phase, err) => this._sendProactive(`❌ Phase ${phase} error: ${err}`),
+      onError: (phase, err) => this._sendProactive(err),
       onQuestionAsked: (text) => this._sendProactiveWithId(text),
     });
 
@@ -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);
@@ -1123,7 +1124,7 @@ Reply with ONLY one word: small, medium, or large. Nothing else.`;
         const last = lines.slice(-3).map((l) => l.trim().slice(0, 100)).join('\n    ');
         summaries.push(`  Window ${w} (${windows[w]}):\n    ${last || '(idle)'}`);
       }
-      return `[LIVE DEV SESSION] ${devSession} (orchestrator not actively tracking)\n${summaries.join('\n')}`;
+      return `[LIVE DEV SESSION] (agents running independently)\n${summaries.join('\n')}`;
     } catch { return null; }
   }
 

package/package.json

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