kiku-agent 1.3.2 → 1.3.3

package/server/agent/commandRegistry.js

@@ -10,8 +10,10 @@ export const COMMAND_DEFINITIONS = Object.freeze([
   { name: '/mem', usage: '/mem [add|del|search|list|topics|summary|import|export|clear]', desc: 'Manage and summarize long-term memory', insert: '/mem ' },
   { name: '/subagent', usage: '/subagent <research task>', desc: 'Run a bounded Ju Jingyi research subagent', insert: '/subagent ' },
   { name: '/research', usage: '/research <question|status|last|sources|cancel>', desc: 'Run coordinated multi-source Ju Jingyi research', insert: '/research ' },
+  { name: '/sources', usage: '/sources [filter]', desc: 'View verified citations and evidence sources from research', insert: '/sources ' },
+  { name: '/autoresearch', usage: '/autoresearch [on|off|auto]', desc: 'Control automatic deep research triggering mode', insert: '/autoresearch ' },
   { name: '/verify', usage: '/verify <claim>', desc: 'Verify a Ju Jingyi claim with independent workers', insert: '/verify ' },
-  { name: '/debate', usage: '/debate <claim|status|last>', desc: 'Run multi-agent adversarial debate & fact synthesis', insert: '/debate ' },
+  { name: '/debate', usage: '/debate <claim|status|last|cancel>', desc: 'Run multi-agent adversarial debate & fact synthesis', insert: '/debate ' },
   { name: '/timeline', usage: '/timeline [year|era]', desc: 'Render career milestone graphic timeline in terminal', insert: '/timeline ' },
   { name: '/suggestion', usage: '/suggestion [list|run <id|all>|auto|refresh|topic <name>]', desc: 'Generate AI research suggestions & execute with concurrent subagents', insert: '/suggestion ' },
   { name: '/skill', usage: '/skill [learn|list|del|on|off|clear]', desc: 'Teach Kiku how to answer for you', insert: '/skill ' },
@@ -26,12 +28,17 @@ export const COMMAND_DEFINITIONS = Object.freeze([
   { name: '/discover', usage: '/discover [drama|song|stage|photo]', desc: 'Discover something from the catalog', insert: '/discover ' },
   { name: '/stats', usage: '/stats [overview|tokens]', desc: 'Show catalog overview or session token telemetry', insert: '/stats ' },
   { name: '/provider', usage: '/provider [list|use <name> [model]|url [provider] [url]|models [name]|setkey [provider] <key>|info <name>|test|status]', desc: 'Manage AI providers and unified API Base URLs (LM Studio, vLLM, OpenAI, Gemini, Groq, DeepSeek, OpenRouter)', insert: '/provider ' },
-  { name: '/lan', usage: '/lan [scan [<cidr|range|ip>,...] [--ports p1,p2]|use <n>|json]', desc: 'Scan the local network (or custom CIDR/ranges) for LM Studio / vLLM / Ollama servers and list their models', insert: '/lan ' },
-  { name: '/model', usage: '/model [status|ping|list|recommend|use <id>|reconnect]', desc: 'Inspect, recommend, or switch active AI model', insert: '/model ' },
+  { name: '/url', usage: '/url [provider] [baseUrl]', desc: 'Inspect or update AI provider API Base URL', insert: '/url ' },
+  { name: '/endpoint', usage: '/endpoint [provider] [baseUrl]', desc: 'Inspect or configure provider API endpoint URL', insert: '/endpoint ' },
+  { name: '/lan', usage: '/lan [scan [<cidr|range|ip|name>,...] [--iface <n|name>] [--ports p1,p2] [--force]|ifs|use <n> [model]|json]', desc: 'List interfaces (/lan ifs), scan one LAN or custom ranges for LM Studio / vLLM / Ollama servers, and connect (scan results persist across restarts)', insert: '/lan ' },
+  { name: '/model', usage: '/model [status|engine [lms|vllm]|config [options]|preset [id]|files|load <id>|stop|unload|temp|topp|minp|repeat|ctx|thinking|list|use <id>|recommend|reconnect]', desc: 'Manage AI model, active local engines (LM Studio / vLLM), load config, presets, installed GGUF files, and inference parameters', insert: '/model ' },
+  { name: '/unload', usage: '/unload [lms|vllm|all]', desc: 'Unload active model from LM Studio or vLLM and release GPU VRAM', insert: '/unload ' },
+  { name: '/ping', usage: '/ping [provider]', desc: 'Ping model endpoint and measure round-trip latency', insert: '/ping ' },
   { name: '/vram', usage: '/vram [check <model>|live|compare|ctx|list|tier] [--ctx <len>] [--quant <type>] [--force]', desc: 'Predictive VRAM analyzer: footprint, live usage, quant/context ladders, hardware tier & pre-flight check', insert: '/vram ' },
   { name: '/eval', usage: '/eval [ui|dashboard|validate|quick|run|judge|compare|gate|status]', desc: 'Manage evaluation studio, benchmarks, and performance dashboards', insert: '/eval ' },
   { name: '/hub', usage: '/hub [filter]', desc: 'Show Kiku Master Command Center hub with hardware telemetry & command index', insert: '/hub' },
   { name: '/portal', usage: '/portal [open|api|chat|eval|status] [port]', desc: 'Inspect or open local portal, REST API docs, Web Chat, or Eval Studio (port 3000)', insert: '/portal ' },
+  { name: '/web', usage: '/web [start|open|stop|status|restart] [port]', desc: 'Launch or manage standalone web chatbot on port 3002', insert: '/web ' },
   { name: '/profile', usage: '/profile [list|use <name>|show <name>|save <name>|delete <name>]', desc: 'Manage configuration profiles (default, fast, deep-reasoning, cloud, gemini)', insert: '/profile ' },
   { name: '/mcp', usage: '/mcp [status|list|connect <name> <url|cmd>|disconnect <name>|remove <name>|reconnect [all]|save|reload|tools]', desc: 'Manage persistent Model Context Protocol connections', insert: '/mcp ' },
   { name: '/config', usage: '/config', desc: 'Show runtime configuration', insert: '/config' },
@@ -40,9 +47,12 @@ export const COMMAND_DEFINITIONS = Object.freeze([
   { name: '/prompt', usage: '/prompt', desc: 'Preview the active system persona', insert: '/prompt' },
   { name: '/system', usage: '/system', desc: 'Show operating-system and memory information', insert: '/system' },
   { name: '/gpu', usage: '/gpu [status]', desc: 'Show GPU & VRAM hardware resource metrics', insert: '/gpu' },
+  { name: '/process', usage: '/process [list|kill <name|pid>]', desc: 'Inspect running background child processes, track PIDs, and kill process trees', insert: '/process ' },
   { name: '/about', usage: '/about', desc: 'Show information about Kiku Agent', insert: '/about' },
-  { name: '/quiz', usage: '/quiz [lang]', desc: 'Take the 15-question Ju Jingyi quiz to claim a Developer VIP Key', insert: '/quiz ' },
+  { name: '/version', usage: '/version [info]', desc: 'Show Kiku Agent version, runtime environment, and OS platform', insert: '/version' },
+  { name: '/quiz', usage: '/quiz [lang|mcp]', desc: 'Take the Ju Jingyi quiz to claim a Developer VIP or MCP API Key', insert: '/quiz ' },
   { name: '/key', usage: '/key [show|apply <key>|clear]', desc: 'Manage your Developer VIP API Key', insert: '/key ' },
+  { name: '/mcp-key', usage: '/mcp-key [show|apply <key>|clear|config]', desc: 'Manage your Ju Jingyi MCP API Key', insert: '/mcp-key ' },
   { name: '/ads', usage: '/ads', desc: 'Show the next sponsor card', insert: '/ads' },
   { name: '/gallery', usage: '/gallery', desc: 'Show the next Ju Jingyi image in the terminal', insert: '/gallery' },
   { name: '/retry', usage: '/retry', desc: 'Retry the previous query', insert: '/retry' },
@@ -63,7 +73,6 @@ export const COMMAND_DEFINITIONS = Object.freeze([
   { name: '/search', usage: '/search <query>', desc: 'Search YouTube', insert: '/search ' },
   { name: '/current', usage: '/current', desc: 'Show the current track', insert: '/current' },
   { name: '/queue', usage: '/queue [clear]', desc: 'Show or clear the active queue', insert: '/queue ' },
-  { name: '/web', usage: '/web [start|open|stop|status|restart] [port]', desc: 'Start or open the standalone chatbot web app (port 3002)', insert: '/web ' },
   { name: '/login', usage: '/login', desc: 'Connect a YouTube browser session', insert: '/login' },
   { name: '/ytstatus', usage: '/ytstatus', desc: 'Show YouTube authentication status', insert: '/ytstatus' },
   { name: '/exit', usage: '/exit', desc: 'Archive the session and quit', insert: '/exit' },
@@ -82,7 +91,7 @@ export const COMMAND_CATEGORIES = Object.freeze([
     id: 'research',
     name: 'Research & Intelligence',
     icon: '✦',
-    commands: ['/research', '/subagent', '/verify', '/debate', '/suggestion', '/jobs'],
+    commands: ['/research', '/subagent', '/verify', '/debate', '/suggestion', '/sources', '/autoresearch', '/jobs'],
   },
   {
     id: 'catalog',
@@ -94,7 +103,7 @@ export const COMMAND_CATEGORIES = Object.freeze([
     id: 'model',
     name: 'AI Model & MCP Connectivity',
     icon: '●',
-    commands: ['/provider', '/lan', '/model', '/profile', '/mcp', '/prompt', '/config', '/env'],
+    commands: ['/provider', '/url', '/endpoint', '/lan', '/model', '/unload', '/ping', '/profile', '/mcp', '/prompt', '/config', '/env'],
   },
   {
     id: 'media',
@@ -106,21 +115,24 @@ export const COMMAND_CATEGORIES = Object.freeze([
     id: 'system',
     name: 'System, Theme & Developer Tools',
     icon: '◆',
-    commands: ['/doctor', '/system', '/gpu', '/vram', '/eval', '/hub', '/portal', '/theme', '/lang', '/quiz', '/key', '/about', '/tools', '/tool', '/ads'],
+    commands: ['/doctor', '/system', '/gpu', '/vram', '/process', '/eval', '/hub', '/portal', '/theme', '/lang', '/quiz', '/key', '/mcp-key', '/about', '/version', '/tools', '/tool', '/ads'],
   },
 ]);
 
 export const SUB_COMMANDS = Object.freeze({
-  '/help': ['find', 'web', 'provider', 'model', 'session', 'details', 'copy', 'mcp', 'mem', 'research', 'verify', 'suggestion', 'skill', 'theme', 'quiz', 'key', 'play', 'doctor'],
+  '/help': ['find', 'web', 'provider', 'model', 'session', 'details', 'copy', 'mcp', 'mem', 'research', 'verify', 'debate', 'timeline', 'suggestion', 'skill', 'theme', 'quiz', 'key', 'mcp-key', 'play', 'doctor'],
   '/web': ['start', 'open', 'status', 'stop', 'restart', '3001'],
   '/mem': ['add <fact>', 'search <query>', 'list', 'topics', 'summary', 'del <id>', 'import <path>', 'export', 'clear'],
-  '/quiz': ['lang th', 'lang en', 'lang zh'],
+  '/quiz': ['mcp', 'lang th', 'lang en', 'lang zh'],
   '/key': ['show', 'apply <key>', 'clear'],
+  '/mcp-key': ['show', 'apply <key>', 'clear', 'config'],
   '/subagent': ['<research task>', 'status', 'last'],
   '/research': ['<question>', 'status', 'last', 'sources', 'auto on|off|status', 'cancel'],
-  '/verify': ['<claim>'],
+  '/sources': ['', 'weibo', 'baidu', 'youtube', 'bilibili'],
+  '/autoresearch': ['on', 'off', 'auto', 'status'],
+  '/verify': ['<claim>', 'status', 'last'],
   '/debate': ['<claim>', 'status', 'last', 'cancel'],
-  '/timeline': ['2026', '2024-2026', 'snh48', 'solo', 'studio', 'drama'],
+  '/timeline': ['2026', '2025', '2024', 'snh48', 'solo', 'studio', 'drama', 'music'],
   '/suggestion': ['list', 'run 1', 'run all', 'auto', 'refresh', 'topic drama', 'topic music', 'topic fashion', 'topic 2026'],
   '/skill': ['learn <instruction>', 'list', 'del <id>', 'on', 'off', 'clear'],
   '/find': ['--type work', '--type song', '--type role', '--type brand', '--type award', '--type photo', '--type stage', '--year 2026', '--limit 8'],
@@ -131,7 +143,7 @@ export const SUB_COMMANDS = Object.freeze({
   '/jobs': ['list', 'show <id>', 'cancel <id>', 'clear'],
   '/discover': ['drama', 'song', 'stage', 'photo', 'song --mood calm', 'stage --year 2025'],
   '/stats': ['overview', 'tokens', 'session'],
-  '/vram': ['check <model_path_or_name> --ctx 8192 --quant q4_k_m', 'live', 'compare --ctx 16384', 'ctx --quant q4_k_m', 'list', 'tier'],
+  '/vram': ['check google/gemma-4-e4b --ctx 8192 --quant q4_k_m', 'live', 'compare --ctx 16384', 'ctx --quant q4_k_m', 'list', 'tier'],
   '/eval': ['ui', 'dashboard', 'validate', 'quick', 'run', 'judge', 'compare', 'gate', 'status'],
   '/hub': ['', '<filter>'],
   '/portal': ['open', 'api', 'chat', 'eval', 'status', '3000'],
@@ -174,22 +186,61 @@ export const SUB_COMMANDS = Object.freeze({
     'test deepseek',
     'test lmstudio'
   ],
-  '/model': ['status', 'ping', 'list', 'recommend', 'use <model-id>', 'reconnect'],
-  '/lan': ['scan', 'scan 192.168.0.0/24', 'scan 10.0.0.1-10.0.0.50 --ports 1234,8000', 'use <n>', 'json'],
+  '/url': ['', 'lmstudio', 'vllm', 'ollama', 'openai', 'gemini', 'groq', 'deepseek', 'openrouter', 'reset'],
+  '/endpoint': ['', 'lmstudio', 'vllm', 'ollama', 'openai', 'gemini', 'groq', 'deepseek', 'openrouter'],
+  '/model': [
+    'status',
+    'engine',
+    'engine lms',
+    'engine vllm',
+    'config',
+    'config --gpu max --threads 8',
+    'config --mem-util 0.85 --enforce-eager',
+    'config --reset',
+    'preset',
+    'preset gemma4',
+    'preset vllm',
+    'preset qwen',
+    'preset gemini',
+    'preset groq',
+    'preset deepseek',
+    'preset luna',
+    'preset openrouter',
+    'files',
+    'load <model-id>',
+    'stop [engine]',
+    'unload [engine]',
+    'temp',
+    'topp',
+    'ctx',
+    'thinking',
+    'ping',
+    'list',
+    'recommend',
+    'use <model-id>',
+    'reconnect'
+  ],
+  '/unload': ['lms', 'vllm', 'all'],
+  '/ping': ['', 'lmstudio', 'vllm', 'ollama', 'openai', 'gemini', 'groq', 'deepseek', 'openrouter'],
+  '/lan': ['ifs', 'scan', 'scan --iface Wi-Fi', 'scan 192.168.0.0/24', 'scan 10.0.0.1-10.0.0.50 --ports 1234,8000', 'use <n>', 'use 1 <model>', 'json'],
   '/profile': ['list', 'use default', 'use fast', 'use deep-reasoning', 'use cloud', 'use gemini', 'show default', 'save <name>', 'delete <name>'],
   '/mcp': ['status', 'list', 'tools', 'connect <name> <url>', 'disconnect <name>', 'remove <name>', 'reconnect [all]', 'save', 'reload'],
   '/config': ['status'],
   '/doctor': ['check'],
-  '/prompt': ['show'],
+  '/prompt': ['show', 'rules'],
   '/system': ['info'],
-  '/gpu': ['status'],
+  '/gpu': ['status', 'live'],
+  '/process': ['list', 'kill <name|pid>'],
   '/about': ['info'],
+  '/version': ['info'],
+  '/tools': ['', 'drama', 'music', 'brand', 'mcp', 'search'],
+  '/tool': ['search_works', 'get_profile_and_fandom', 'search_discography', 'search_brands'],
   '/ads': ['next'],
-  '/gallery': ['show'],
-  '/retry': ['again'],
-  '/cancel': ['stop'],
-  '/clear': ['now'],
-  '/save': ['markdown'],
+  '/gallery': ['show', 'random', '2026', '2025', '2024'],
+  '/retry': ['again', 'force'],
+  '/cancel': ['stop', 'all'],
+  '/clear': ['now', 'session'],
+  '/save': ['markdown', 'json', 'html', 'text'],
   '/lang': ['th', 'zh', 'en', 'auto'],
   '/theme': ['next', 'prev', 'list', 'current', 'sakura', 'midnight', 'ocean', 'forest', 'sunset', 'monochrome', 'reset'],
   '/thinking': ['show', 'hide', 'toggle'],
@@ -383,16 +434,48 @@ export const COMMAND_DETAILS = Object.freeze({
       '/provider models',
     ],
   },
+  '/url': {
+    summary: 'Inspect or configure the unified API Base URL for local or cloud AI providers',
+    usage: '/url [provider] [baseUrl | reset]',
+    subcommands: [
+      { cmd: '', desc: 'Show currently configured API Base URL and connectivity for the active provider', example: '/url' },
+      { cmd: '<provider>', desc: 'Show Base URL and connectivity for a specific provider (lmstudio, vllm, ollama, openai, gemini, groq, deepseek, openrouter)', example: '/url vllm' },
+      { cmd: '<provider> <url>', desc: 'Set and persist a custom API Base URL for the specified provider', example: '/url vllm http://127.0.0.1:8000/v1' },
+      { cmd: 'reset <provider>', desc: 'Reset provider Base URL to default built-in endpoint', example: '/url reset lmstudio' },
+    ],
+    examples: [
+      '/url',
+      '/url vllm',
+      '/url lmstudio http://127.0.0.1:1234/v1',
+      '/url vllm http://localhost:8000/v1',
+      '/url reset vllm',
+    ],
+  },
+  '/endpoint': {
+    summary: 'Inspect or configure provider API endpoint URL (alias to /provider url / /url)',
+    usage: '/endpoint [provider] [baseUrl]',
+    subcommands: [
+      { cmd: '', desc: 'Display active provider endpoint URL, connectivity latency, and status', example: '/endpoint' },
+      { cmd: '<provider> <url>', desc: 'Update and persist custom API endpoint URL for an AI provider', example: '/endpoint vllm http://localhost:8000/v1' },
+    ],
+    examples: [
+      '/endpoint',
+      '/endpoint lmstudio http://127.0.0.1:1234/v1',
+      '/endpoint vllm http://localhost:8000/v1',
+    ],
+  },
   '/lan': {
-    summary: 'Discover LM Studio / vLLM / Ollama servers on the local network — auto or custom ranges — and switch to them',
-    usage: '/lan [scan [<cidr|range|ip>,...] [--ports p1,p2] | use <n> | json]',
+    summary: 'List interfaces, discover LM Studio / vLLM / Ollama servers on one LAN or custom ranges — and switch to them',
+    usage: '/lan [scan [<cidr|range|ip|name>,...] [--iface <n|name>] [--ports p1,p2] [--force] | ifs | use <n> [model] | json]',
     subcommands: [
+      { cmd: 'ifs', desc: 'List local network interfaces (index, type, status, subnet, gateway) to pick one for scanning', example: '/lan ifs' },
       { cmd: 'scan', desc: 'Scan the private subnets of every local interface (plus 127.0.0.1) for OpenAI-compatible LM servers', example: '/lan scan' },
+      { cmd: 'scan --iface <n|name>', desc: 'Scan only the subnet of one interface (index or name from /lan ifs); explicit targets still win', example: '/lan scan --iface Wi-Fi --ports 1234,8000' },
       { cmd: 'scan <targets>', desc: 'Scan custom ranges: CIDR any prefix, IP range a.b.c.d-e.f.g.h, or single IPs, comma-separated (private ranges only, capped by KIKU_LAN_SCAN_MAX_HOSTS)', example: '/lan scan 192.168.0.0/24, 10.0.0.1-10.0.0.50 --ports 1234,8000' },
-      { cmd: 'use <n>', desc: 'Switch provider/baseUrl to a numbered endpoint from the last scan and connect to its first model', example: '/lan use 1' },
+      { cmd: 'use <n> [model]', desc: 'Switch provider/baseUrl to a numbered endpoint from the last scan (kept across restarts) and connect to the picked model', example: '/lan use 1 qwen' },
       { cmd: 'json', desc: 'Print the last scan result as raw JSON', example: '/lan json' },
     ],
-    examples: ['/lan', '/lan scan 192.168.0.0/24', '/lan scan 10.0.0.1-10.0.0.50 --ports 1234,8000', '/lan use 2', '/lan json'],
+    examples: ['/lan', '/lan ifs', '/lan scan --iface Wi-Fi', '/lan scan 192.168.0.0/24', '/lan scan 10.0.0.1-10.0.0.50 --ports 1234,8000', '/lan use 2', '/lan use 1 qwen', '/lan json'],
   },
   '/key': {
     summary: 'Manage your Developer VIP API Key (earned via /quiz or custom seed)',
@@ -409,10 +492,23 @@ export const COMMAND_DETAILS = Object.freeze({
     ],
   },
   '/model': {
-    summary: 'Inspect, recommend, or switch active AI model',
-    usage: '/model [status | list | recommend | use <model-id> | reconnect]',
-    subcommands: [
-      { cmd: 'status', desc: 'Display active model name, provider, latency, and context configuration', example: '/model status' },
+    summary: 'Manage AI models, active local engines, fine-tuned load config, presets, GGUFs, and inference parameters',
+    usage: '/model [status | engine [lms|vllm] | config [flags] | preset [id] | files | load <model-id> | stop | unload | temp | topp | minp | repeat | ctx | thinking | list | use <model-id> | recommend | reconnect]',
+    subcommands: [
+      { cmd: 'status', desc: 'Display active model, provider, active engine, port status, and inference configuration', example: '/model status' },
+      { cmd: 'engine [lms|vllm]', desc: 'Inspect active local engine, port reachability (1234 / 8000), OS compatibility, or switch active engine', example: '/model engine vllm' },
+      { cmd: 'config [--gpu N] [--threads N] [--split-mode layer|row] [--tensor-split ratios] [--main-gpu N] [--fa] [--no-fa] [-b N] [-ub N] [--ctk DT] [--mem-util F] [--tp N] [--reset]', desc: 'Inspect or configure fine-tuned engine load parameters (multi-GPU, flash-attn, batching) for LM Studio and vLLM', example: '/model config --split-mode layer --tensor-split 20,12 --fa' },
+      { cmd: 'preset [id]', desc: 'List or apply curated 1-click model presets matching Web Chat (gemma4, vllm, qwen, gemini, groq, deepseek, luna, openrouter)', example: '/model preset gemma4' },
+      { cmd: 'files', desc: 'Scan and list installed local GGUF models on disk with file size and quantization details', example: '/model files' },
+      { cmd: 'load <model-id> [options]', desc: 'Load model with fine-tuned parameters on active engine (LM Studio or vLLM on WSL2)', example: '/model load google/gemma-4-e4b --engine vllm --mem-util 0.85' },
+      { cmd: 'stop [engine]', desc: 'Stop background engine process (vLLM or LM Studio) to free GPU VRAM and system memory', example: '/model stop vllm' },
+      { cmd: 'unload [engine]', desc: 'Unload active model from engine and release GPU VRAM', example: '/model unload lms' },
+      { cmd: 'temp [val]', desc: 'Inspect or adjust generation creativity (temperature 0.0 - 2.0)', example: '/model temp 0.7' },
+      { cmd: 'topp [val]', desc: 'Inspect or adjust nucleus sampling cutoff (top-p 0.01 - 1.0)', example: '/model topp 0.95' },
+      { cmd: 'minp [val]', desc: 'Inspect or adjust Min-P sampling threshold (0.00 - 1.00, recommended 0.05 - 0.10)', example: '/model minp 0.08' },
+      { cmd: 'repeat [val]', desc: 'Inspect or adjust token repetition penalty (1.00 - 2.00, recommended 1.05 - 1.15)', example: '/model repeat 1.10' },
+      { cmd: 'ctx [len]', desc: 'Inspect or adjust context window limit (e.g. 4k, 8k, 16k, 32k, 64k, 128k)', example: '/model ctx 16k' },
+      { cmd: 'thinking [show|collapse|hide]', desc: 'Configure chain-of-thought thinking visibility mode', example: '/model thinking show' },
       { cmd: 'ping', desc: 'Ping the active model endpoint and report round-trip latency', example: '/model ping' },
       { cmd: 'list', desc: 'List models reported by the active provider or local LM Studio instance', example: '/model list' },
       { cmd: 'use <model-id>', desc: 'Switch active model immediately without restarting the agent', example: '/model use google/gemma-4-e4b' },
@@ -421,10 +517,49 @@ export const COMMAND_DETAILS = Object.freeze({
     ],
     examples: [
       '/model status',
+      '/model engine vllm',
+      '/model config --gpu max --threads 8',
+      '/model config --split-mode layer --tensor-split 20,12 --fa',
+      '/model preset gemma4',
+      '/model files',
+      '/model load google/gemma-4-e4b --engine lms --gpu max',
+      '/model temp 0.7',
+      '/model minp 0.08',
+      '/model repeat 1.10',
+      '/model ctx 16k',
+      '/model unload lms',
       '/model list',
-      '/model recommend',
       '/model use gemma-4-e4b',
-      '/model reconnect',
+    ],
+  },
+  '/unload': {
+    summary: 'Unload active model from LM Studio or vLLM to immediately release GPU VRAM',
+    usage: '/unload [lms | vllm | all]',
+    subcommands: [
+      { cmd: '', desc: 'Unload current active model from the active engine and free GPU VRAM', example: '/unload' },
+      { cmd: 'lms', desc: 'Unload loaded models from LM Studio and release VRAM', example: '/unload lms' },
+      { cmd: 'vllm', desc: 'Stop vLLM inference server and free GPU memory', example: '/unload vllm' },
+      { cmd: 'all', desc: 'Unload all models across local engines', example: '/unload all' },
+    ],
+    examples: [
+      '/unload',
+      '/unload lms',
+      '/unload vllm',
+      '/unload all',
+    ],
+  },
+  '/ping': {
+    summary: 'Ping active model endpoint or provider server and measure round-trip network latency',
+    usage: '/ping [provider]',
+    subcommands: [
+      { cmd: '', desc: 'Send lightweight ping probe to active model endpoint and report round-trip latency in ms', example: '/ping' },
+      { cmd: '<provider>', desc: 'Ping a specific provider server endpoint (lmstudio, vllm, ollama, groq, gemini, etc.)', example: '/ping vllm' },
+    ],
+    examples: [
+      '/ping',
+      '/ping vllm',
+      '/ping lmstudio',
+      '/ping groq',
     ],
   },
   '/research': {
@@ -446,31 +581,109 @@ export const COMMAND_DETAILS = Object.freeze({
   },
   '/verify': {
     summary: 'Verify a Ju Jingyi claim or rumor with independent workers across official catalog & web sources',
-    usage: '/verify <claim about Ju Jingyi>',
+    usage: '/verify <claim about Ju Jingyi> | /verify status',
     subcommands: [
-      { cmd: '<claim>', desc: 'Run multi-worker verification to produce a strict verdict (VERIFIED, UNVERIFIED, CONFLICTING, FALSE)', example: '/verify จวีจิ้งอีเป็น Brand Ambassador ของ Versace ในปี 2026' },
+      { cmd: '<claim>', desc: 'Run 3-stage verification (Catalog -> Web Corroboration -> Contradiction Analysis) to produce a strict verdict', example: '/verify จวีจิ้งอีเป็น Brand Ambassador ของ Versace ในปี 2026' },
+      { cmd: 'status', desc: 'Display progress and status of active claim verification job', example: '/verify status' },
     ],
     examples: [
       '/verify จวีจิ้งอีชนะเลือกตั้ง SNH48 สองสมัยซ้อน',
       '/verify Ju Jingyi will star in a new 2026 historical drama',
     ],
   },
+  '/sources': {
+    summary: 'Inspect verified citations, URLs, and grounded evidence collected from queries and research',
+    usage: '/sources [filter]',
+    subcommands: [
+      { cmd: '', desc: 'List grounded citations, categories, tools, and URLs from the last query or research run', example: '/sources' },
+      { cmd: '[filter]', desc: 'Filter verified citations by keyword, domain, or catalog category (e.g. weibo, drama, ost)', example: '/sources weibo' },
+    ],
+    examples: [
+      '/sources',
+      '/sources official',
+      '/sources drama',
+    ],
+  },
+  '/autoresearch': {
+    summary: 'Control automatic deep research triggering mode for complex or multi-part queries',
+    usage: '/autoresearch [on | off | auto | status]',
+    subcommands: [
+      { cmd: 'on', desc: 'Aggressive mode — route every query with a research signal into multi-worker deep research', example: '/autoresearch on' },
+      { cmd: 'off', desc: 'Disabled mode — let the active model answer directly according to default persona rules', example: '/autoresearch off' },
+      { cmd: 'auto', desc: 'Smart heuristic mode — automatically trigger deep research when questions are complex or multi-part (default)', example: '/autoresearch auto' },
+      { cmd: 'status', desc: 'Display current auto-research triggering mode and environment setting', example: '/autoresearch status' },
+    ],
+    examples: [
+      '/autoresearch auto',
+      '/autoresearch on',
+      '/autoresearch off',
+      '/autoresearch status',
+    ],
+  },
+  '/debate': {
+    summary: 'Run multi-agent adversarial debate, cross-examination, and fact synthesis between Pro and Con subagents',
+    usage: '/debate <claim|topic> | /debate status | /debate last | /debate cancel',
+    subcommands: [
+      { cmd: '<claim|topic>', desc: 'Launch multi-agent adversarial debate (Advocate vs Skeptic) with judge synthesis', example: '/debate จวีจิ้งอีจะคัมแบ็กผลงานเพลงเดี่ยวในปี 2026' },
+      { cmd: 'status', desc: 'Display real-time state and round progress of active debate job', example: '/debate status' },
+      { cmd: 'last', desc: 'Display comprehensive debate findings matrix, evidence scores, and final verdict', example: '/debate last' },
+      { cmd: 'cancel', desc: 'Abort the currently executing adversarial debate session', example: '/debate cancel' },
+    ],
+    examples: [
+      '/debate Ju Jingyi SNH48 election records',
+      '/debate status',
+      '/debate last',
+    ],
+  },
+  '/timeline': {
+    summary: 'Render career milestone graphic timeline in terminal (SNH48, Solo, Studio, dramas, music, brands)',
+    usage: '/timeline [year | start-end | era | all]',
+    subcommands: [
+      { cmd: '[year]', desc: 'Display milestones and achievements for a specific year', example: '/timeline 2024' },
+      { cmd: '[start-end]', desc: 'Display milestones within an inclusive year range', example: '/timeline 2018-2024' },
+      { cmd: '[era]', desc: 'Filter milestones by career era, group, or project tag (e.g. SNH48, Solo, Studio)', example: '/timeline SNH48' },
+      { cmd: 'all', desc: 'Render the complete full career milestone timeline from debut to present', example: '/timeline all' },
+    ],
+    examples: [
+      '/timeline',
+      '/timeline 2024',
+      '/timeline 2020-2025',
+      '/timeline SNH48',
+    ],
+  },
 
   '/quiz': {
-    summary: 'Interactive 15-question Ju Jingyi quiz to claim a Developer VIP Key (1,000 req/min)',
-    usage: '/quiz [lang <th|en|zh>]',
+    summary: 'Interactive Ju Jingyi quiz to claim a Developer VIP Key (15 Qs) or MCP API Key (12 Qs)',
+    usage: '/quiz [mcp | lang <th|en|zh>]',
     subcommands: [
-      { cmd: '', desc: 'Start the quiz in your current language setting', example: '/quiz' },
+      { cmd: '', desc: 'Start the VIP quiz in your current language setting', example: '/quiz' },
+      { cmd: 'mcp', desc: 'Start the 12-question MCP challenge for an MCP Key', example: '/quiz mcp' },
       { cmd: 'lang th', desc: 'Start the quiz in Thai', example: '/quiz lang th' },
       { cmd: 'lang en', desc: 'Start the quiz in English', example: '/quiz lang en' },
       { cmd: 'lang zh', desc: 'Start the quiz in Chinese', example: '/quiz lang zh' },
     ],
     examples: [
       '/quiz',
+      '/quiz mcp',
       '/quiz lang th',
       '/quiz lang en',
     ],
   },
+  '/mcp-key': {
+    summary: 'Manage your Ju Jingyi MCP API Key (earned via /quiz mcp)',
+    usage: '/mcp-key [show | apply <key> | clear | config]',
+    subcommands: [
+      { cmd: '', desc: 'Show currently stored MCP API Key and tier', example: '/mcp-key' },
+      { cmd: 'config', desc: 'Display Claude Desktop & Cursor JSON configuration snippet', example: '/mcp-key config' },
+      { cmd: 'apply <key>', desc: 'Manually apply an existing MCP key', example: '/mcp-key apply kiku_mcp_sk_...' },
+      { cmd: 'clear', desc: 'Clear stored MCP key from memory preferences', example: '/mcp-key clear' },
+    ],
+    examples: [
+      '/mcp-key',
+      '/mcp-key config',
+      '/mcp-key clear',
+    ],
+  },
   '/subagent': {
     summary: 'Spawn an isolated iterative research subagent to investigate a specific task or subtopic',
     usage: '/subagent <task | status | last>',
@@ -648,7 +861,7 @@ export const COMMAND_DETAILS = Object.freeze({
     summary: 'Inspect or clear music playback audio queue',
     usage: '/queue [clear]',
     subcommands: [
-      { cmd: '', desc: 'Show currently queued music tracks and playback state', example: '/queue' },
+      { cmd: '', desc: 'Show currently queued music tracks, playing state, and playlist positions', example: '/queue' },
       { cmd: 'clear', desc: 'Wipe all pending tracks from the music queue', example: '/queue clear' },
     ],
     examples: [
@@ -660,39 +873,59 @@ export const COMMAND_DETAILS = Object.freeze({
     summary: 'Show GPU & VRAM hardware resource metrics',
     usage: '/gpu [status]',
     subcommands: [
-      { cmd: 'status', desc: 'Show real-time NVIDIA/Metal GPU compute utilization and VRAM memory usage', example: '/gpu' },
+      { cmd: '', desc: 'Show real-time NVIDIA/Metal GPU compute utilization and VRAM memory usage', example: '/gpu' },
+      { cmd: 'status', desc: 'Display GPU device name, temperature, compute load %, and VRAM allocated/total', example: '/gpu status' },
     ],
     examples: [
       '/gpu',
+      '/gpu status',
+    ],
+  },
+  '/process': {
+    summary: 'Manage background child processes (vLLM, LM Studio, audio, eval) with PID tracking and clean tree termination',
+    usage: '/process [list | kill <name | pid>]',
+    subcommands: [
+      { cmd: 'list', desc: 'List all running background child processes with PID, status, command, and uptime', example: '/process list' },
+      { cmd: 'kill <name|pid>', desc: 'Terminate a background process tree cleanly (taskkill on Windows / SIGTERM on POSIX)', example: '/process kill vllm' },
+    ],
+    examples: [
+      '/process list',
+      '/process kill vllm',
+      '/process kill 1234',
     ],
   },
   '/tools': {
     summary: 'List registered SSOT knowledge and external tools',
     usage: '/tools [filter]',
     subcommands: [
-      { cmd: '[filter]', desc: 'List all registered tools or filter by keyword', example: '/tools drama' },
+      { cmd: '', desc: 'List all registered catalog, search, media, and MCP tools', example: '/tools' },
+      { cmd: '[filter]', desc: 'Filter registered tools by keyword, domain, or category (e.g. drama, music, mcp)', example: '/tools drama' },
     ],
     examples: [
       '/tools',
       '/tools search',
       '/tools mcp',
+      '/tools drama',
     ],
   },
   '/cancel': {
     summary: 'Abort the currently running query, tool, or subagent task',
-    usage: '/cancel',
+    usage: '/cancel [all]',
     subcommands: [
-      { cmd: '', desc: 'Instantly cancel running model generation, tool execution, or research subagents', example: '/cancel' },
+      { cmd: '', desc: 'Instantly cancel running model generation, active tool execution, or research subagents', example: '/cancel' },
+      { cmd: 'all', desc: 'Abort all active queries, background research workers, and pending tasks', example: '/cancel all' },
     ],
     examples: [
       '/cancel',
+      '/cancel all',
     ],
   },
   '/tool': {
     summary: 'Execute a registered SSOT tool directly with arguments',
     usage: '/tool <name> [json_args | raw_query]',
     subcommands: [
-      { cmd: '<name> [args]', desc: 'Call tool directly without model synthesis', example: '/tool search_works {"year":2026}' },
+      { cmd: '<name> [json_args]', desc: 'Call tool directly with structured JSON arguments without model synthesis', example: '/tool search_works {"year":2026}' },
+      { cmd: '<name> [raw_query]', desc: 'Call tool directly using plain search keywords as input', example: '/tool search_works In Blossom' },
     ],
     examples: [
       '/tool get_profile_and_fandom',
@@ -737,11 +970,12 @@ export const COMMAND_DETAILS = Object.freeze({
 
   '/config': {
     summary: 'Display current runtime configuration, active profile, provider, paths, and environment settings',
-    usage: '/config',
+    usage: '/config [env]',
     subcommands: [
       { cmd: '', desc: 'Inspect active profile, LLM provider, base URL, model name, storage directories, and MCP status', example: '/config' },
+      { cmd: 'env', desc: 'Inspect active environment variable mappings, paths, and configuration overrides', example: '/config env' },
     ],
-    examples: ['/config'],
+    examples: ['/config', '/config env'],
   },
   '/env': {
     summary: 'Create and manage the local .env file for global npm installs — only necessary values are set, optional ones stay commented',
@@ -770,76 +1004,108 @@ export const COMMAND_DETAILS = Object.freeze({
   },
   '/doctor': {
     summary: 'Run environment diagnostics, dependency verification, and feature health check',
-    usage: '/doctor',
+    usage: '/doctor [check]',
     subcommands: [
       { cmd: '', desc: 'Check Node version, LM Studio server, yt-dlp, ffmpeg, MCP server, and disk permissions', example: '/doctor' },
+      { cmd: 'check', desc: 'Perform exhaustive health probe across all local services and external tools', example: '/doctor check' },
     ],
-    examples: ['/doctor'],
+    examples: ['/doctor', '/doctor check'],
   },
   '/prompt': {
     summary: 'Preview the full system prompt and active persona instructions sent to the AI',
-    usage: '/prompt',
+    usage: '/prompt [system]',
     subcommands: [
       { cmd: '', desc: 'Inspect the system persona, memory context, and domain rules passed to the LLM', example: '/prompt' },
+      { cmd: 'system', desc: 'View raw system prompt lines with persona constraints and anti-refusal policies', example: '/prompt system' },
     ],
-    examples: ['/prompt'],
+    examples: ['/prompt', '/prompt system'],
   },
 
   '/system': {
     summary: 'Display host operating system, CPU architecture, memory usage, and Node process stats',
-    usage: '/system',
+    usage: '/system [metrics]',
     subcommands: [
       { cmd: '', desc: 'Show platform OS, total RAM, heap memory allocation, process uptime, and architecture', example: '/system' },
+      { cmd: 'metrics', desc: 'Inspect detailed Node heap memory consumption and process uptime', example: '/system metrics' },
     ],
-    examples: ['/system'],
+    examples: ['/system', '/system metrics'],
   },
   '/about': {
     summary: 'Display background information, credits, architecture overview, and project links',
-    usage: '/about',
+    usage: '/about [info]',
     subcommands: [
       { cmd: '', desc: 'Show project mission, tech stack overview, creator credits, and documentation links', example: '/about' },
+      { cmd: 'info', desc: 'Display engine details, registered tools count, and active language modes', example: '/about info' },
+    ],
+    examples: ['/about', '/about info'],
+  },
+  '/version': {
+    summary: 'Display Kiku Agent package version, Node.js runtime, OS platform, and architecture',
+    usage: '/version [info]',
+    subcommands: [
+      { cmd: '', desc: 'Display Kiku Agent version, release tier, Node.js runtime version, and platform', example: '/version' },
+      { cmd: 'info', desc: 'Show detailed environment summary including engine, registered tools count, and language modes', example: '/version info' },
+    ],
+    examples: [
+      '/version',
+      '/version info',
     ],
-    examples: ['/about'],
   },
   '/ads': {
     summary: 'Display community sponsor card and featured ecosystem highlights',
-    usage: '/ads',
+    usage: '/ads [next]',
     subcommands: [
-      { cmd: '', desc: 'Cycle and display the next sponsor spotlight card in the terminal', example: '/ads' },
+      { cmd: '', desc: 'Display community sponsor spotlight card in the terminal', example: '/ads' },
+      { cmd: 'next', desc: 'Cycle and display the next sponsor spotlight card in the terminal', example: '/ads next' },
     ],
-    examples: ['/ads'],
+    examples: ['/ads', '/ads next'],
   },
   '/gallery': {
     summary: 'Render full-color terminal graphic portraits of Ju Jingyi from the asset gallery',
-    usage: '/gallery',
+    usage: '/gallery [hd | single | list | <number> | pair]',
     subcommands: [
-      { cmd: '', desc: 'Display a high-resolution downsampled ANSI image portrait in the terminal', example: '/gallery' },
+      { cmd: '', desc: 'Display a default dual portrait pair in the terminal', example: '/gallery' },
+      { cmd: 'hd / single', desc: 'Render a single high-resolution ANSI image card in the terminal', example: '/gallery hd' },
+      { cmd: 'list', desc: 'List all available gallery images with index numbers and capture dates', example: '/gallery list' },
+      { cmd: '<number>', desc: 'Display a specific portrait by its photo catalog number', example: '/gallery 1' },
+      { cmd: 'pair', desc: 'Render two portraits side by side in the terminal', example: '/gallery pair' },
     ],
-    examples: ['/gallery'],
+    examples: ['/gallery', '/gallery hd', '/gallery list', '/gallery 1'],
   },
   '/retry': {
     summary: 'Re-execute the previous query with identical prompt parameters',
-    usage: '/retry',
+    usage: '/retry [force]',
     subcommands: [
       { cmd: '', desc: 'Resend the previous question to the active model for a fresh response', example: '/retry' },
+      { cmd: 'force', desc: 'Force re-execution bypassing local prompt cache or intermediate state', example: '/retry force' },
+    ],
+    examples: [
+      '/retry',
+      '/retry force',
     ],
-    examples: ['/retry'],
   },
   '/clear': {
     summary: 'Archive active conversation session and reset terminal screen buffer',
-    usage: '/clear',
+    usage: '/clear [session]',
     subcommands: [
-      { cmd: '', desc: 'Archive current session to disk, reset message history, and clear viewport', example: '/clear' },
+      { cmd: '', desc: 'Archive current session to disk, reset message history, and reset terminal viewport to welcome hero', example: '/clear' },
+      { cmd: 'session', desc: 'Archive the active session and start a fresh session ID', example: '/clear session' },
+    ],
+    examples: [
+      '/clear',
+      '/clear session',
     ],
-    examples: ['/clear'],
   },
   '/save': {
-    summary: 'Export the full active conversation transcript to a formatted Markdown file',
-    usage: '/save',
+    summary: 'Export the full active conversation transcript to a formatted Markdown, JSON, or Text file',
+    usage: '/save [markdown | json | html | text]',
     subcommands: [
-      { cmd: '', desc: 'Write complete conversation history, reasoning, and tools to an exported Markdown file', example: '/save' },
+      { cmd: '', desc: 'Write complete conversation history, reasoning, and tools to a Markdown file (.md)', example: '/save' },
+      { cmd: 'markdown', desc: 'Export transcript as standard Markdown with tool blocks and formatting', example: '/save markdown' },
+      { cmd: 'json', desc: 'Export session history and metadata as structured JSON', example: '/save json' },
+      { cmd: 'text', desc: 'Export clean plain text transcript without formatting marks', example: '/save text' },
     ],
-    examples: ['/save'],
+    examples: ['/save', '/save markdown', '/save json', '/save text'],
   },
   '/stop': {
     summary: 'Stop active background audio stream and clear playback process',
@@ -926,38 +1192,43 @@ export const COMMAND_DETAILS = Object.freeze({
     usage: '/search <query>',
     subcommands: [
       { cmd: '<query>', desc: 'Search YouTube for tracks and display title, duration, and direct links', example: '/search In Blossom OST' },
+      { cmd: '<song_name>', desc: 'Search specific Ju Jingyi song title or Chinese pinyin keywords', example: '/search 恋爱告急' },
     ],
-    examples: ['/search 鞠婧祎', '/search In Blossom OST'],
+    examples: ['/search 鞠婧祎', '/search In Blossom OST', '/search 恋爱告急'],
   },
   '/current': {
     summary: 'Show metadata, duration, and status for the currently playing audio track',
-    usage: '/current',
+    usage: '/current [status]',
     subcommands: [
       { cmd: '', desc: 'Display track title, elapsed playback duration, buffer state, and YouTube link', example: '/current' },
+      { cmd: 'status', desc: 'Inspect current streaming buffer status, process PID, and audio volume', example: '/current status' },
     ],
-    examples: ['/current'],
+    examples: ['/current', '/current status'],
   },
   '/login': {
     summary: 'Authenticate YouTube session in the browser to enable age-gated music playback',
-    usage: '/login',
+    usage: '/login [browser]',
     subcommands: [
       { cmd: '', desc: 'Open interactive browser session to save YouTube cookies for seamless streaming', example: '/login' },
+      { cmd: 'browser', desc: 'Launch browser authentication flow for YouTube session cookies', example: '/login browser' },
     ],
-    examples: ['/login'],
+    examples: ['/login', '/login browser'],
   },
   '/ytstatus': {
     summary: 'Show YouTube authentication, cookie source, and streaming player status',
-    usage: '/ytstatus',
+    usage: '/ytstatus [check]',
     subcommands: [
       { cmd: '', desc: 'Check cookie availability, browser profile connection, and playback backend health', example: '/ytstatus' },
+      { cmd: 'check', desc: 'Force re-check of YouTube credentials, yt-dlp binary, and ffmpeg availability', example: '/ytstatus check' },
     ],
-    examples: ['/ytstatus'],
+    examples: ['/ytstatus', '/ytstatus check'],
   },
   '/exit': {
     summary: 'Archive active conversation session and exit Kiku Agent CLI',
-    usage: '/exit',
+    usage: '/exit [quit]',
     subcommands: [
       { cmd: '', desc: 'Safely save active session state to disk and close terminal application', example: '/exit' },
+      { cmd: 'quit', desc: 'Immediate clean teardown and exit terminal', example: '/exit quit' },
     ],
     examples: ['/exit'],
   },
@@ -1000,13 +1271,71 @@ export const COMMAND_DETAILS = Object.freeze({
   },
 });
 
+export const COMMAND_ALIASES = Object.freeze({
+  '/quit': '/exit', '/q': '/exit',
+  '/web-chat': '/web',
+  '/abort': '/cancel',
+  '/cp': '/copy', '/clip': '/copy', '/clipboard': '/copy',
+  '/?': '/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',
+  '/themes': '/theme',
+  '/suggest': '/suggestion', '/suggestions': '/suggestion',
+  '/exec': '/tool', '/call': '/tool',
+  '/toollist': '/tools',
+  '/lookup': '/find', '/findall': '/find',
+  '/cmp': '/compare',
+  '/fav': '/favorites', '/favs': '/favorites',
+  '/latest': '/news',
+  '/job': '/jobs',
+  '/random': '/discover',
+  '/metrics': '/stats', '/catalog': '/stats',
+  '/llm': '/model', '/engine': '/model',
+  '/health': '/ping',
+  '/settings': '/config', '/conf': '/config',
+  '/persona': '/prompt', '/sysprompt': '/prompt',
+  '/ver': '/version', '/v': '/version',
+  '/sys': '/system', '/os': '/system',
+  '/gpus': '/gpu',
+  '/ps': '/process', '/processes': '/process',
+  '/resource': '/vram',
+  '/benchmark': '/eval', '/evaluation': '/eval',
+  '/center': '/hub',
+  '/app': '/portal', '/webportal': '/portal',
+  '/info': '/about',
+  '/sponsor': '/ads', '/ad': '/ads',
+  '/image': '/gallery', '/photo': '/gallery',
+  '/cls': '/clear', '/reset': '/clear',
+  '/export': '/save', '/markdown': '/save',
+  '/src': '/sources', '/srcs': '/sources',
+  '/r': '/retry',
+  '/kvip': '/key',
+  '/switch': '/provider',
+  '/providers': '/provider',
+  '/profiles': '/profile',
+  '/preset': '/profile',
+  '/presets': '/profile',
+  '/ingestion': '/ingest',
+});
+
+export function resolveCommandAlias(name) {
+  if (!name) return '';
+  const normalized = name.startsWith('/') ? name.toLowerCase() : `/${String(name).toLowerCase()}`;
+  return COMMAND_ALIASES[normalized] || normalized;
+}
+
 export function findCommandDefinition(name) {
-  const normalized = name?.startsWith('/') ? name.toLowerCase() : `/${String(name || '').toLowerCase()}`;
-  return COMMAND_DEFINITIONS.find(command => command.name === normalized) || null;
+  if (!name) return null;
+  const canonical = resolveCommandAlias(name);
+  return COMMAND_DEFINITIONS.find(command => command.name === canonical) || null;
 }
 
 export function getCommandDetails(name) {
   if (!name) return null;
-  const normalized = name.startsWith('/') ? name.toLowerCase() : `/${String(name).toLowerCase()}`;
-  return COMMAND_DETAILS[normalized] || null;
+  const canonical = resolveCommandAlias(name);
+  return COMMAND_DETAILS[canonical] || null;
 }