kiku-agent 1.0.9 → 1.0.10

package/README.md

@@ -87,7 +87,7 @@ Automatic installation is available for global npm installs. Source checkouts, l
 
 After an update or rollback, restart `kiku-agent` and any application hosting `kiku-mcp`. Update settings and rollback history are stored in the normal Kiku user data directory as `update-state.json`; sessions, memory, `.env`, and YouTube cookies are not modified.
 
-For a local checkout before the package is published, use `npm pack` followed by `npm install -g ./kiku-agent-1.0.9.tgz`.
+For a local checkout before the package is published, use `npm pack` followed by `npm install -g ./kiku-agent-1.0.10.tgz`.
 
 ### ✨ Features
 - **LM Studio Integration**: Connects seamlessly to LM Studio's OpenAI-compatible server at `http://127.0.0.1:1234/v1` (default model `google/gemma-4-e4b`, with auto-detection of loaded models).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kiku-agent",
-  "version": "1.0.9",
+  "version": "1.0.10",
   "description": "Kiku AI terminal agent and MCP server for Ju Jingyi knowledge, media, and career data.",
   "license": "GPL-3.0",
   "type": "module",
@@ -29,10 +29,10 @@
   "kikuUpdate": {
     "channel": "stable",
     "releaseSummary": [
-      "Added graceful 404 error handling for unpublished channels and non-existent version lookups",
-      "Enhanced CLI update diagnostics with active release channel switching guidance",
-      "Updated production model defaults and live fallback resolution across cloud providers",
-      "Hardened REST API key validation and isolated rate-limit probes"
+      "Added session restore and resume support",
+      "Fixed CJK fullwidth table wrapping in TUI",
+      "Enhanced React 19 rendering safety",
+      "Added comprehensive version bump tool"
     ],
     "releaseUrl": "https://www.npmjs.com/package/kiku-agent"
   },
@@ -63,7 +63,8 @@
     "kiku-agent": "node server/agent/cli.js",
     "kiku-mcp": "node server/mcp/stdio.js",
     "kiku-ink": "npx tsx server/agent/ink/main.jsx",
-    "test": "node --test server/agent/tests/*.test.js server/mcp/tests/*.test.js"
+    "test": "node --test server/agent/tests/*.test.js server/mcp/tests/*.test.js",
+    "bump": "node bump_version.js"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.30.0",

package/server/agent/agentCore.js

@@ -12,8 +12,8 @@ import { ResearchOrchestrator } from './research.js';
 import { SuggestionEngine } from './suggestions.js';
 import { McpClientManager } from './mcpClient.js';
 import { DynamicToolRouter } from './toolRouter.js';
-import { contextCompactor } from './contextCompactor.js';
-import { AgentJobManager } from './jobManager.js';
+import { contextCompactor } from './contextCompactor.js';
+import { AgentJobManager } from './jobManager.js';
 
 export function detectDominantLanguage(text) {
   if (!text || typeof text !== 'string') return 'th';
@@ -64,8 +64,8 @@ export class KikuAgent {
     this.mcpManager = options.mcpManager || new McpClientManager();
     this.router = new DynamicToolRouter(this.getAllToolsSchema());
     this.research = new ResearchOrchestrator({ client: this.client });
-    this.suggestions = new SuggestionEngine({ client: this.client, memory: this.memory });
-    this.jobs = new AgentJobManager();
+    this.suggestions = new SuggestionEngine({ client: this.client, memory: this.memory });
+    this.jobs = new AgentJobManager();
     this.systemPrompt = this.buildSystemPrompt();
     this.initHistory();
     this.restoredMessageCount = 0;
@@ -103,39 +103,39 @@ export class KikuAgent {
     return this._ready;
   }
 
-  async runSubagent(task, options = {}) {
-    await this._ready;
-    return this.jobs.run('subagent', task, async ({ signal }) => {
-      const subagent = new ResearchSubagent({
-        client: this.client,
-        maxIterations: options.maxIterations || 3,
-      });
-      return subagent.run(task, {
-        signal,
-        onProgress: options.onProgress,
-        skillContext: this.memory.buildUserSkillContext(),
-      });
-    }, options);
-  }
-
-  async runResearch(question, options = {}) {
-    await this._ready;
-    const type = options.mode === 'verify' ? 'verify' : 'research';
-    return this.jobs.run(type, question, ({ signal }) => this.research.run(question, {
-      ...options,
-      signal,
-      skillContext: this.memory.buildUserSkillContext(),
-    }), options);
+  async runSubagent(task, options = {}) {
+    await this._ready;
+    return this.jobs.run('subagent', task, async ({ signal }) => {
+      const subagent = new ResearchSubagent({
+        client: this.client,
+        maxIterations: options.maxIterations || 3,
+      });
+      return subagent.run(task, {
+        signal,
+        onProgress: options.onProgress,
+        skillContext: this.memory.buildUserSkillContext(),
+      });
+    }, options);
+  }
+
+  async runResearch(question, options = {}) {
+    await this._ready;
+    const type = options.mode === 'verify' ? 'verify' : 'research';
+    return this.jobs.run(type, question, ({ signal }) => this.research.run(question, {
+      ...options,
+      signal,
+      skillContext: this.memory.buildUserSkillContext(),
+    }), options);
   }
 
   getResearchStatus() {
     return this.research.getStatus();
   }
 
-  cancelResearch() {
-    const direct = this.research.cancel();
-    const tracked = this.jobs.cancelType('research') || this.jobs.cancelType('verify');
-    return direct || tracked;
+  cancelResearch() {
+    const direct = this.research.cancel();
+    const tracked = this.jobs.cancelType('research') || this.jobs.cancelType('verify');
+    return direct || tracked;
   }
 
   async generateSuggestions(options = {}) {
@@ -143,33 +143,33 @@ export class KikuAgent {
     return this.suggestions.generateSuggestions(options);
   }
 
-  async runSuggestionBatch(targets, options = {}) {
-    await this._ready;
-    return this.jobs.run('suggestion', String(targets || 'all'), ({ signal }) => this.suggestions.runBatchSubagents(targets, {
-      ...options,
-      signal,
-    }), options);
-  }
-
-  getLastSuggestions() {
-    return this.suggestions.getLastSuggestions();
-  }
-
-  getJobs() {
-    return this.jobs.list();
-  }
-
-  getJob(id) {
-    return this.jobs.get(id);
-  }
-
-  cancelJob(id) {
-    return this.jobs.cancel(id);
-  }
-
-  clearJobs() {
-    return this.jobs.clear();
-  }
+  async runSuggestionBatch(targets, options = {}) {
+    await this._ready;
+    return this.jobs.run('suggestion', String(targets || 'all'), ({ signal }) => this.suggestions.runBatchSubagents(targets, {
+      ...options,
+      signal,
+    }), options);
+  }
+
+  getLastSuggestions() {
+    return this.suggestions.getLastSuggestions();
+  }
+
+  getJobs() {
+    return this.jobs.list();
+  }
+
+  getJob(id) {
+    return this.jobs.get(id);
+  }
+
+  cancelJob(id) {
+    return this.jobs.cancel(id);
+  }
+
+  clearJobs() {
+    return this.jobs.clear();
+  }
 
   initHistory() {
     this.conversationHistory = [
@@ -223,6 +223,59 @@ export class KikuAgent {
     }
   }
 
+  async restoreSession(sessionId) {
+    await this._ready;
+    if (!sessionId) return null;
+
+    let targetSessionId = String(sessionId).trim();
+    const archives = this.memory.getArchivedSessions(50);
+    if (/^\d+$/.test(targetSessionId)) {
+      const idx = parseInt(targetSessionId, 10) - 1;
+      if (archives[idx]) {
+        targetSessionId = archives[idx].id;
+      }
+    } else {
+      const match = archives.find(s => s.id === targetSessionId || s.id.toLowerCase().includes(targetSessionId.toLowerCase()));
+      if (match) {
+        targetSessionId = match.id;
+      }
+    }
+
+    const archived = await this.memory.loadArchivedSession(targetSessionId);
+    if (!archived) return null;
+
+    if (this.session.messages.length > 0 && this.session.id !== targetSessionId) {
+      await this.memory.archiveSession(this.session.toSnapshot()).catch(() => {});
+    }
+
+    this.session.restoreFromSnapshot(archived);
+    await this.session.saveToDisk().catch(() => {});
+
+    this.initHistory();
+    for (const msg of this.session.messages) {
+      if (msg.role === 'user') {
+        const textPart = msg.parts?.find(p => p.type === 'text');
+        if (textPart?.content) {
+          this.conversationHistory.push({
+            role: 'user',
+            content: textPart.content
+          });
+        }
+      } else if (msg.role === 'assistant') {
+        const textPart = msg.parts?.find(p => p.type === 'text');
+        if (textPart?.content) {
+          this.conversationHistory.push({
+            role: 'assistant',
+            content: textPart.content
+          });
+        }
+      }
+    }
+    this.restoredMessageCount = this.session.messages.length;
+    eventBus.emit(Events.SESSION_SAVED, { sessionId: this.session.id });
+    return archived;
+  }
+
   getEnrichedSystemPrompt() {
     const memoryContext = this.memory.buildMemoryContext();
     return this.systemPrompt + memoryContext;

package/server/agent/commandRegistry.js

@@ -1,7 +1,7 @@
 export const COMMAND_DEFINITIONS = Object.freeze([
   { name: '/help', usage: '/help [command]', desc: 'Show all commands or details for one command', insert: '/help ' },
   { name: '/history', usage: '/history [n|search|summary|clear]', desc: 'View, search, or summarize chat history', insert: '/history ' },
-  { name: '/session', usage: '/session [info|summary|list|export|clear]', desc: 'Manage or summarize the current session', insert: '/session ' },
+  { name: '/session', usage: '/session [info|summary|list|load <id>|export|clear]', desc: 'Manage, restore, or summarize conversation sessions', insert: '/session ' },
   { name: '/thinking', usage: '/thinking [show|hide|toggle]', desc: 'Control reasoning visibility', insert: '/thinking ' },
   { name: '/details', usage: '/details [Qn] [overview|answer|thinking|tools|tool n]', desc: 'Inspect query diagnostics (F2 opens latest overview)', insert: '/details ' },
   { name: '/copy', usage: '/copy [Qn] [answer|thinking|tools|tool n|all|markdown]', desc: 'Copy full untruncated model answer, thinking, or diagnostics to clipboard', insert: '/copy ' },
@@ -87,7 +87,7 @@ export const SUB_COMMANDS = Object.freeze({
   '/thinking': ['show', 'hide', 'toggle'],
   '/details': ['latest', 'overview', 'answer', 'thinking', 'tools', 'tool <n>', 'all', 'markdown', 'Q1 overview', 'Q1 tool 1'],
   '/copy': ['answer', 'thinking', 'tools', 'tool 1', 'overview', 'all', 'markdown', 'Q1 answer', 'Q1 thinking', 'Q1 all'],
-  '/session': ['info', 'summary', 'list', 'export', 'clear'],
+  '/session': ['info', 'summary', 'list', 'load <id>', 'export', 'clear'],
   '/history': ['10', '20', '50', 'search <query>', 'summary', 'clear'],
   '/queue': ['clear'],
   '/update': ['check', 'install', 'install next', 'install canary', 'channel', 'channel latest', 'channel next', 'channel canary', 'rollback', 'help'],
@@ -408,12 +408,13 @@ export const COMMAND_DETAILS = Object.freeze({
     ],
   },
   '/session': {
-    summary: 'Manage current conversation session, storage, and snapshots',
-    usage: '/session [info | list | export | clear]',
+    summary: 'Manage, restore, or summarize conversation sessions and history snapshots',
+    usage: '/session [info | summary | list | load <id> | export | clear]',
     subcommands: [
       { cmd: 'info', desc: 'Display session ID, active duration, message count, and turn stats', example: '/session info' },
       { cmd: 'summary', desc: 'Synthesize an AI analytical summary of the active session', example: '/session summary' },
       { cmd: 'list', desc: 'List all saved conversation sessions on disk', example: '/session list' },
+      { cmd: 'load <id>', desc: 'Restore and resume an archived session by ID or list number', example: '/session load 1' },
       { cmd: 'export', desc: 'Export full conversation session history to JSON', example: '/session export' },
       { cmd: 'clear', desc: 'Archive current conversation session and reset history', example: '/session clear' },
     ],
@@ -421,6 +422,7 @@ export const COMMAND_DETAILS = Object.freeze({
       '/session info',
       '/session summary',
       '/session list',
+      '/session load 1',
       '/session clear',
     ],
   },

package/server/agent/commands.js

@@ -771,10 +771,14 @@ export const handlers = {
   },
 
   '/session': async (ctx) => {
-    const { agent, sub } = ctx;
+    const { agent, sub, extra } = ctx;
     const sess = agent.session;
     const action = (sub || 'info').toLowerCase();
 
+    if (/^\d+$/.test(action) || action.startsWith('sess_')) {
+      return handlers['/session']({ ...ctx, sub: 'load', extra: sub });
+    }
+
     if (action === 'info' || !action) {
       const msgCount = sess.messages.length;
       const userMsgs = sess.messages.filter(m => m.role === 'user').length;
@@ -839,10 +843,10 @@ export const handlers = {
         title: `Archived Sessions (Total: ${sessions.length})`,
         lines: sessions.length === 0
           ? [`${C.dim}No archived sessions found.${C.reset}`]
-          : sessions.map(s => {
+          : sessions.map((s, i) => {
             const date = new Date(s.createdAt).toLocaleString();
             const dur = ((s.stats?.totalDurationMs || 0) / 1000).toFixed(1);
-            return `${C.gold}${s.id}${C.reset} ${C.dim}(${date})${C.reset} — ${s.messageCount} msgs, ${dur}s`;
+            return `${C.gold}[${i + 1}] ${s.id}${C.reset} ${C.dim}(${date})${C.reset} — ${s.messageCount} msgs, ${dur}s`;
           }),
         headerBg: '\x1b[48;2;48;54;70m',
         bg: '\x1b[48;2;36;40;52m'
@@ -850,6 +854,60 @@ export const handlers = {
       return 'HANDLED';
     }
 
+    if (action === 'load' || action === 'resume' || action === 'restore') {
+      const target = (extra || '').trim();
+      if (!target) {
+        const sessions = agent.memory.getArchivedSessions(10);
+        if (sessions.length === 0) {
+          console.log(`\n  ${C.amber}No archived sessions available to load.${C.reset}\n`);
+          return 'HANDLED';
+        }
+        printSolidPanel({
+          title: 'Load Session Usage',
+          lines: [
+            `${C.dim}Specify a session ID or list number to resume:${C.reset}`,
+            '',
+            ...sessions.map((s, i) => {
+              const date = new Date(s.createdAt).toLocaleString();
+              return `  ${C.gold}[${i + 1}]${C.reset} ${C.bold}${C.white}${s.id}${C.reset} ${C.dim}(${date} — ${s.messageCount} msgs)${C.reset}`;
+            }),
+            '',
+            `${C.dim}Example: /session load 1  OR  /session load ${sessions[0].id}${C.reset}`,
+          ],
+          headerBg: '\x1b[48;2;48;54;70m',
+          bg: '\x1b[48;2;36;40;52m',
+        });
+        return 'HANDLED';
+      }
+
+      const restored = await agent.restoreSession(target);
+      if (!restored) {
+        console.log(`\n  ${C.amber}Session "${target}" not found. Use /session list to view available archives.${C.reset}\n`);
+        return 'HANDLED';
+      }
+
+      const date = restored.createdAt ? new Date(restored.createdAt).toLocaleString() : 'unknown';
+      const msgCount = restored.messages?.length || 0;
+      const totalDur = (((restored.stats?.totalDurationMs) || 0) / 1000).toFixed(1);
+
+      printSolidPanel({
+        title: 'Session Restored Successfully',
+        lines: [
+          `${C.gold}Session ID:${C.reset}      ${C.bold}${C.white}${restored.id}${C.reset}`,
+          `${C.gold}Created At:${C.reset}      ${C.white}${date}${C.reset}`,
+          `${C.gold}Restored Messages:${C.reset} ${C.cyberCyan}${msgCount}${C.reset} exchanges loaded into memory`,
+          `${C.gold}Total Queries:${C.reset}   ${C.cyberCyan}${restored.stats?.totalQueries || 0}${C.reset}`,
+          `${C.gold}Tool Invocations:${C.reset} ${C.cyberCyan}${restored.stats?.totalToolCalls || 0}${C.reset}`,
+          `${C.gold}Total Duration:${C.reset}  ${C.cyberCyan}${totalDur}s${C.reset}`,
+          '',
+          `${C.emerald}✓ Session conversation context reloaded. You can now continue chatting!${C.reset}`,
+        ],
+        headerBg: '\x1b[48;2;48;54;70m',
+        bg: '\x1b[48;2;36;40;52m',
+      });
+      return 'HANDLED';
+    }
+
     if (action === 'export') {
       const exported = await agent.session.exportToMarkdown();
       console.log(`\n  ${C.emerald}[OK] Session transcript exported.${C.reset}`);
@@ -863,7 +921,7 @@ export const handlers = {
       return 'HANDLED';
     }
 
-    console.log(`\n  ${C.amber}Unknown session action: "${sub}". Use /session [info|list|export|clear]${C.reset}\n`);
+    console.log(`\n  ${C.amber}Unknown session action: "${sub}". Use /session [info|summary|list|load|export|clear]${C.reset}\n`);
     return 'HANDLED';
   },
 
@@ -1168,7 +1226,16 @@ export const handlers = {
 
   '/stop': async () => { await audioPlayer.stop(); console.log(`\n  ${C.emerald}[OK] Stopped${C.reset}\n`); return 'HANDLED'; },
   '/pause': async () => { const r = await audioPlayer.pause(); console.log(`\n  ${C.emerald}${r}${C.reset}\n`); return 'HANDLED'; },
-  '/resume': async () => { const r = await audioPlayer.resume(); console.log(`\n  ${C.emerald}${r}${C.reset}\n`); return 'HANDLED'; },
+  '/resume': async (ctx) => {
+    const { sub, extra } = ctx || {};
+    if (sub) {
+      const target = extra ? `${sub} ${extra}`.trim() : sub;
+      return handlers['/session']({ ...ctx, sub: 'load', extra: target });
+    }
+    const r = await audioPlayer.resume();
+    console.log(`\n  ${C.emerald}${r}${C.reset}\n`);
+    return 'HANDLED';
+  },
   '/next': async () => { const r = await audioPlayer.next(); console.log(`\n  ${C.emerald}${r}${C.reset}\n`); return 'HANDLED'; },
   '/prev': async () => { const r = await audioPlayer.prev(); console.log(`\n  ${C.emerald}${r}${C.reset}\n`); return 'HANDLED'; },
   '/mute': async () => { const r = await audioPlayer.mute(); console.log(`\n  ${C.emerald}${r}${C.reset}\n`); return 'HANDLED'; },
@@ -2580,6 +2647,7 @@ const ALIASES = {
   '/?': '/help', '/commands': '/help', '/menu': '/help',
   '/hist': '/history', '/h': '/history',
   '/sess': '/session', '/sessions': '/session',
+  '/load-session': '/session', '/load': '/session', '/restore': '/session',
   '/think': '/thinking', '/th': '/thinking',
   '/detail': '/details', '/d': '/details',
   '/language': '/lang',

package/server/agent/session.js

@@ -160,6 +160,20 @@ export class AgentSession {
     };
   }
 
+  restoreFromSnapshot(sessionData) {
+    if (!sessionData) return false;
+    this.id = sessionData.id || `sess_${Date.now()}_${Math.random().toString(36).slice(2, 7)}`;
+    this.createdAt = sessionData.createdAt ? new Date(sessionData.createdAt) : new Date();
+    this.thinkingMode = sessionData.thinkingMode || 'hide';
+    this.messages = Array.isArray(sessionData.messages) ? sessionData.messages : [];
+    this.stats = sessionData.stats || {
+      totalQueries: 0,
+      totalToolCalls: 0,
+      totalDurationMs: 0
+    };
+    return true;
+  }
+
   reset() {
     this.id = `sess_${Date.now()}_${Math.random().toString(36).slice(2, 7)}`;
     this.createdAt = new Date();

package/server/agent/ui.js

@@ -130,9 +130,13 @@ function getGraphemeDisplayWidth(segment) {
     if (
       (code >= 0x1100 && code <= 0x11FF) ||
       (code >= 0x2E80 && code <= 0x9FFF) ||
+      (code >= 0x3000 && code <= 0x303F) ||
       (code >= 0xAC00 && code <= 0xD7A3) ||
       (code >= 0xF900 && code <= 0xFAFF) ||
-      (code >= 0xFE30 && code <= 0xFE4F)
+      (code >= 0xFE30 && code <= 0xFE4F) ||
+      (code >= 0xFF01 && code <= 0xFF60) ||  
+      (code >= 0xFFE0 && code <= 0xFFE6) ||
+      (code >= 0x20000 && code <= 0x3FFFF) 
     ) {
       width += 2;
     } else {
@@ -297,7 +301,7 @@ export function wrapText(text, maxWidth = 72) {
 
 
 export function stripAnsi(str) {
-  return str.replace(/\x1b\[[0-9;]*m/g, '');
+  return String(str ?? '').replace(/\x1b(?:\[[0-?]*[ -/]*[@-~]|\][^\x07]*(?:\x07|\x1b\\))/g, '');
 }
 
 export function sanitizeTerminalText(value, maxLength = 2000) {
@@ -751,8 +755,8 @@ export function formatTerminalMarkdown(text) {
   if (!text) return '';
   return text
     .replace(/^###\s*(.+)$/gm, `${C.bold}${C.gold}✦ $1${C.reset}`)
-    .replace(/^##\s*(.+)$/gm, `\n${C.bold}${C.roseGlow}■ $1${C.reset}`)
-    .replace(/^#\s*(.+)$/gm, `\n${C.bold}${C.sakura}━━━ $1 ━━━${C.reset}`)
+    .replace(/^##\s*(.+)$/gm, `${C.bold}${C.roseGlow}■ $1${C.reset}`)
+    .replace(/^#\s*(.+)$/gm, `${C.bold}${C.sakura}━━━ $1 ━━━${C.reset}`)
     .replace(/^>\s*(.+)$/gm, `  ${C.slate}│${C.reset} ${C.italic}${C.white}$1${C.reset}`)
     .replace(/\[([^\]]+)\]\((https?:\/\/[^\s)]+)\)/g, `${C.bold}${C.cyberCyan}$1${C.reset} ➔ ${C.underline}${C.roseGlow}$2${C.reset}`)
     .replace(/\*{3}([^*]+)\*{3}/g, `${C.bold}${C.italic}${C.white}$1${C.reset}`)
@@ -854,7 +858,7 @@ export function formatMarkdownLines(text, maxWidth = getFullWidth() - 8) {
   return result;
 }
 
-export function getWelcomeHeroLines() {
+export function getWelcomeHeroLines() {
   const p = C.sakura;
   const r = C.roseGlow;
   const g = C.gold;
@@ -866,8 +870,8 @@ export function getWelcomeHeroLines() {
   const b = C.bold;
   const d = C.dim;
   const rst = C.reset;
-  const boxWidth = Math.min(84, Math.max(50, getFullWidth() - 4));
-  const compact = getFullWidth() < 120;
+  const boxWidth = Math.min(84, Math.max(50, getFullWidth() - 4));
+  const compact = getFullWidth() < 120;
   const headerTitle = 'Suggested Topics & Queries';
   const topDashCount = Math.max(2, boxWidth - getStringDisplayWidth(headerTitle) - 6);
   const innerWidth = boxWidth - 2;
@@ -880,28 +884,28 @@ export function getWelcomeHeroLines() {
     return `  ${s}│${rst}  ${icon} ${tag}${rst}${' '.repeat(Math.max(0, tagWidth - getStringDisplayWidth(tag)))}  ${w}${text}${rst}${' '.repeat(pad)}${s}│${rst}`;
   };
 
-  const heroLines = compact ? [
-    `  ${b}${p}◆ Ju Jingyi • 鞠婧祎 • Mìjú Terminal Portal ◆${rst}`,
-    `  ${p}██╗  ██╗██╗██╗  ██╗██╗   ██╗     █████╗ ██╗${rst}`,
-    `  ${r}█████═╝ ██║█████═╝ ██║   ██║    ███████║██║${rst}`,
-  ] : [
-    `  ${p}██╗  ██╗██╗██╗  ██╗██╗   ██╗     █████╗ ██╗${rst}   ${b}${p}◆ Ju Jingyi • 鞠婧祎 • Mìjú Terminal Portal ◆${rst}`,
-    `  ${p}██║ ██╔╝██║██║ ██╔╝██║   ██║    ██╔══██╗██║${rst}   ${d}${s}Interactive Fan Knowledge Base & Autonomous Agent${rst}`,
-    `  ${r}█████═╝ ██║█████═╝ ██║   ██║    ███████║██║${rst}   ${d}${s}Filmography • Discography • Fashion & Awards${rst}`,
-    `  ${r}██╔═██╗ ██║██╔═██╗ ██║   ██║    ██╔══██╗██║${rst}   ${c}● Live Ready${rst} ${s}• Multilingual (CN / EN / TH)${rst}`,
-    `  ${p}██║ ╚██╗██║██║ ╚██╗╚██████╔╝    ██║  ██║██║${rst}`,
-    `  ${p}╚═╝  ╚═╝╚═╝╚═╝  ╚═╝ ╚═════╝     ╚═╝  ╚═╝╚═╝${rst}`,
-  ];
-  const shortcutLines = compact ? [
-    `  ${s}Shortcuts: ${b}${w}[Tab]${rst} ${s}Commands • ${b}${w}[↑/↓]${rst} ${s}History • ${b}${w}[F2]${rst} ${s}Details${rst}`,
-    `  ${b}${w}[PgUp/PgDn]${rst} ${s}Scroll • ${b}${w}[Ctrl+C]${rst} ${s}Exit${rst}`,
-  ] : [
-    `  ${s}Shortcuts: ${b}${w}[Tab]${rst} ${s}Autocomplete • ${b}${w}[↑/↓]${rst} ${s}History • ${b}${w}[PgUp/PgDn]${rst} ${s}Scroll • ${b}${w}[F2]${rst} ${s}Details • ${b}${w}[Ctrl+C]${rst} ${s}Exit${rst}`,
-  ];
-
-  return [
-    ...(compact ? [] : ['']),
-    ...heroLines,
+  const heroLines = compact ? [
+    `  ${b}${p}◆ Ju Jingyi • 鞠婧祎 • Mìjú Terminal Portal ◆${rst}`,
+    `  ${p}██╗  ██╗██╗██╗  ██╗██╗   ██╗     █████╗ ██╗${rst}`,
+    `  ${r}█████═╝ ██║█████═╝ ██║   ██║    ███████║██║${rst}`,
+  ] : [
+    `  ${p}██╗  ██╗██╗██╗  ██╗██╗   ██╗     █████╗ ██╗${rst}   ${b}${p}◆ Ju Jingyi • 鞠婧祎 • Mìjú Terminal Portal ◆${rst}`,
+    `  ${p}██║ ██╔╝██║██║ ██╔╝██║   ██║    ██╔══██╗██║${rst}   ${d}${s}Interactive Fan Knowledge Base & Autonomous Agent${rst}`,
+    `  ${r}█████═╝ ██║█████═╝ ██║   ██║    ███████║██║${rst}   ${d}${s}Filmography • Discography • Fashion & Awards${rst}`,
+    `  ${r}██╔═██╗ ██║██╔═██╗ ██║   ██║    ██╔══██╗██║${rst}   ${c}● Live Ready${rst} ${s}• Multilingual (CN / EN / TH)${rst}`,
+    `  ${p}██║ ╚██╗██║██║ ╚██╗╚██████╔╝    ██║  ██║██║${rst}`,
+    `  ${p}╚═╝  ╚═╝╚═╝╚═╝  ╚═╝ ╚═════╝     ╚═╝  ╚═╝╚═╝${rst}`,
+  ];
+  const shortcutLines = compact ? [
+    `  ${s}Shortcuts: ${b}${w}[Tab]${rst} ${s}Commands • ${b}${w}[↑/↓]${rst} ${s}History • ${b}${w}[F2]${rst} ${s}Details${rst}`,
+    `  ${b}${w}[PgUp/PgDn]${rst} ${s}Scroll • ${b}${w}[Ctrl+C]${rst} ${s}Exit${rst}`,
+  ] : [
+    `  ${s}Shortcuts: ${b}${w}[Tab]${rst} ${s}Autocomplete • ${b}${w}[↑/↓]${rst} ${s}History • ${b}${w}[PgUp/PgDn]${rst} ${s}Scroll • ${b}${w}[F2]${rst} ${s}Details • ${b}${w}[Ctrl+C]${rst} ${s}Exit${rst}`,
+  ];
+
+  return [
+    ...(compact ? [] : ['']),
+    ...heroLines,
     '',
     `  ${s}╭──${rst} ${b}${g}${headerTitle}${rst} ${s}${'─'.repeat(topDashCount)}╮${rst}`,
     padItem(p + '◆', '2026 Works', '"What are Ju Jingyi\'s 2026 upcoming dramas?"'),
@@ -910,7 +914,7 @@ export function getWelcomeHeroLines() {
     padItem(l + '◆', 'Tools / MCP', '"@search_works 2026, /mcp list, /stats, /help"'),
     `  ${s}╰${'─'.repeat(boxWidth)}╯${rst}`,
     '',
-    ...shortcutLines,
+    ...shortcutLines,
     '',
   ];
 }
@@ -1080,7 +1084,7 @@ export function exitAlternateScreen() {
   }
 }
 
-export function getTuiViewportLayout(termRows = 24) {
+export function getTuiViewportLayout(termRows = 24) {
   const parsedRows = Number(termRows);
   const rows = Math.max(10, Number.isFinite(parsedRows) ? Math.floor(parsedRows) : 24);
   const viewportStartRow = 1;
@@ -1095,16 +1099,16 @@ export function getTuiViewportLayout(termRows = 24) {
     statusBarRow,
     promptRow,
     separatorRow,
-  };
-}
-
-export function getNewOutputScrollOffset(addedLineCount, termRows = 24, currentOffset = 0) {
-  const added = Math.max(0, Number.isFinite(Number(addedLineCount)) ? Math.floor(Number(addedLineCount)) : 0);
-  if (currentOffset > 0) return currentOffset + added;
-  return Math.max(0, added - getTuiViewportLayout(termRows).viewportHeight);
-}
-
-export class VirtualScreenBuffer {
+  };
+}
+
+export function getNewOutputScrollOffset(addedLineCount, termRows = 24, currentOffset = 0) {
+  const added = Math.max(0, Number.isFinite(Number(addedLineCount)) ? Math.floor(Number(addedLineCount)) : 0);
+  if (currentOffset > 0) return currentOffset + added;
+  return Math.max(0, added - getTuiViewportLayout(termRows).viewportHeight);
+}
+
+export class VirtualScreenBuffer {
   constructor(width = 80, height = 24, writer = null) {
     this.width = Math.max(10, width);
     this.height = Math.max(5, height);