clawkit-doctor 2.2.0 → 3.0.0

package/README.md

@@ -10,6 +10,12 @@ Maintainer: **@branzoom**
 npx clawkit-doctor@latest
 ```
 
+When run without arguments in an interactive terminal, Doctor now shows:
+
+1. language selector (`en/zh/ja`)
+2. welcome menu (quick diagnose / paste error / tutorial / exit)
+3. guided recovery loop (`y/n` solved confirmation)
+
 ### Common modes
 
 ```bash

package/bin/index.js

@@ -29,7 +29,7 @@ function getArgValue(flag) {
 
 const requestedLang = (getArgValue('--lang') || process.env.LANG || 'en').toLowerCase();
 const LANG = requestedLang.startsWith('zh') ? 'zh' : requestedLang.startsWith('ja') ? 'ja' : 'en';
-const PASTE_TEXT = (getArgValue('--paste') || '').trim();
+const CLI_PASTE_TEXT = (getArgValue('--paste') || '').trim();
 const FULL_MODE = args.has('--full');
 const FIX_MODE = args.has('--fix');
 const JSON_MODE = args.has('--json');
@@ -51,6 +51,25 @@ const report = {
 const i18n = {
   en: {
     subtitle: 'Reliable OpenClaw diagnostics and repair',
+    welcomeTitle: 'Welcome to ClawKit Doctor',
+    welcomeHint: 'Choose what you want to do first.',
+    langChoose: 'Select language: 1=English 2=简体中文 3=日本語',
+    slashHint: 'Type "/" to show command palette.',
+    slashTitle: 'Command palette',
+    slashItemMenu: '/menu  open main menu',
+    slashItemLang: '/lang  switch language',
+    slashItemDiag: '/diag  run quick diagnose',
+    slashItemPaste: '/paste  paste an error now',
+    slashItemGuide: '/guide  show tutorial',
+    slashItemExit: '/exit  quit',
+    menu: 'Menu: 1=Quick diagnose 2=Paste an error 3=How to use 4=Exit',
+    menuPaste: 'Paste your error log/message:',
+    menuGuideTitle: 'Quick tutorial',
+    menuGuide1: '1) Paste the exact error text.',
+    menuGuide2: '2) Run suggested fix steps.',
+    menuGuide3: '3) Confirm solved with y/n.',
+    menuGuide4: '4) If still failing, use fallback + docs link.',
+    menuGuideNext: 'Next: 1=Run diagnose 2=Paste error 4=Exit',
     docs: 'Troubleshooting index',
     prevent: 'Prevention guide',
     explore: 'Explore more skills & workflows',
@@ -76,6 +95,25 @@ const i18n = {
   },
   zh: {
     subtitle: 'OpenClaw 环境诊断与安全修复',
+    welcomeTitle: '欢迎使用 ClawKit Doctor',
+    welcomeHint: '请先选择你要做的事。',
+    langChoose: '选择语言：1=English 2=简体中文 3=日本語',
+    slashHint: '输入“/”可查看命令面板。',
+    slashTitle: '命令面板',
+    slashItemMenu: '/menu  回到主菜单',
+    slashItemLang: '/lang  切换语言',
+    slashItemDiag: '/diag  运行快速检测',
+    slashItemPaste: '/paste  直接粘贴错误',
+    slashItemGuide: '/guide  查看教程',
+    slashItemExit: '/exit  退出',
+    menu: '菜单：1=快速检测 2=粘贴错误 3=使用教程 4=退出',
+    menuPaste: '请粘贴你的错误日志/报错信息：',
+    menuGuideTitle: '快速使用教程',
+    menuGuide1: '1) 粘贴完整错误文本。',
+    menuGuide2: '2) 按步骤执行修复命令。',
+    menuGuide3: '3) 用 y/n 确认是否已解决。',
+    menuGuide4: '4) 未解决就走补救步骤和详情文档。',
+    menuGuideNext: '下一步：1=直接检测 2=粘贴错误 4=退出',
     docs: '故障排查总览',
     prevent: '预防建议',
     explore: '继续探索 skills 与 workflows',
@@ -101,6 +139,25 @@ const i18n = {
   },
   ja: {
     subtitle: 'OpenClaw 環境の診断と安全な修復',
+    welcomeTitle: 'ClawKit Doctor へようこそ',
+    welcomeHint: '最初に実行内容を選んでください。',
+    langChoose: '言語を選択: 1=English 2=简体中文 3=日本語',
+    slashHint: '「/」でコマンドパレットを表示。',
+    slashTitle: 'コマンドパレット',
+    slashItemMenu: '/menu  メインメニューへ',
+    slashItemLang: '/lang  言語を切替',
+    slashItemDiag: '/diag  クイック診断',
+    slashItemPaste: '/paste  エラー貼り付け',
+    slashItemGuide: '/guide  チュートリアル',
+    slashItemExit: '/exit  終了',
+    menu: 'メニュー: 1=クイック診断 2=エラー貼り付け 3=使い方 4=終了',
+    menuPaste: 'エラーログ/メッセージを貼り付けてください:',
+    menuGuideTitle: 'クイックチュートリアル',
+    menuGuide1: '1) 正確なエラー文を貼り付ける。',
+    menuGuide2: '2) 提案された修正手順を実行する。',
+    menuGuide3: '3) y/n で解決確認する。',
+    menuGuide4: '4) 未解決ならフォールバックと詳細ドキュメントへ。',
+    menuGuideNext: '次へ: 1=診断実行 2=エラー貼り付け 4=終了',
     docs: 'トラブルシューティング一覧',
     prevent: '再発防止ガイド',
     explore: 'skills と workflows を探す',
@@ -125,7 +182,10 @@ const i18n = {
     nonInteractive: '対話端末ではないため追跡質問をスキップしました。',
   },
 };
-const t = i18n[LANG];
+let currentLang = LANG;
+let t = i18n[currentLang];
+let languagePrompted = false;
+const LANGUAGE_PROMPT = 'Select language / 选择语言 / 言語を選択: 1=English 2=简体中文 3=日本語';
 
 if (args.has('--help') || args.has('-h')) {
   console.log(`
@@ -577,6 +637,75 @@ async function askBinary(question, fallback = 'n') {
   return fallback;
 }
 
+async function chooseLanguageIfNeeded() {
+  if (!INTERACTIVE_MODE || languagePrompted) return;
+  const choice = await ask(LANGUAGE_PROMPT);
+  if (choice === '1') currentLang = 'en';
+  if (choice === '2') currentLang = 'zh';
+  if (choice === '3') currentLang = 'ja';
+  t = i18n[currentLang];
+  languagePrompted = true;
+}
+
+function printSlashPalette() {
+  console.log(chalk.bold(`\n${t.slashTitle}`));
+  console.log(chalk.gray(`  ${t.slashItemMenu}`));
+  console.log(chalk.gray(`  ${t.slashItemLang}`));
+  console.log(chalk.gray(`  ${t.slashItemDiag}`));
+  console.log(chalk.gray(`  ${t.slashItemPaste}`));
+  console.log(chalk.gray(`  ${t.slashItemGuide}`));
+  console.log(chalk.gray(`  ${t.slashItemExit}\n`));
+}
+
+async function runWelcomeMenu(initialPasteText) {
+  const showMenu = INTERACTIVE_MODE && !JSON_MODE && !FIX_MODE && !FULL_MODE && !initialPasteText;
+  if (!showMenu) return { pasteText: initialPasteText, exit: false };
+
+  await chooseLanguageIfNeeded();
+  console.log(chalk.cyan.bold(`\n${t.welcomeTitle}`));
+  console.log(chalk.gray(`${t.welcomeHint}`));
+  console.log(chalk.gray(`${t.slashHint}\n`));
+
+  while (true) {
+    let choice = (await ask(t.menu)).trim().toLowerCase();
+    if (choice === '/') {
+      printSlashPalette();
+      continue;
+    }
+    if (choice === '/lang') {
+      languagePrompted = false;
+      await chooseLanguageIfNeeded();
+      continue;
+    }
+    if (choice === '4' || choice === 'q' || choice === 'exit' || choice === '/exit') {
+      return { pasteText: '', exit: true };
+    }
+    if (choice === '1' || choice === '/diag' || choice === '/menu') {
+      return { pasteText: '', exit: false };
+    }
+    if (choice === '2' || choice === '/paste') {
+      const pasted = await ask(t.menuPaste);
+      return { pasteText: pasted.trim(), exit: false };
+    }
+    if (choice === '3' || choice === '/guide') {
+      console.log(chalk.bold(`\n${t.menuGuideTitle}`));
+      console.log(chalk.gray(`  ${t.menuGuide1}`));
+      console.log(chalk.gray(`  ${t.menuGuide2}`));
+      console.log(chalk.gray(`  ${t.menuGuide3}`));
+      console.log(chalk.gray(`  ${t.menuGuide4}\n`));
+      choice = (await ask(t.menuGuideNext)).trim().toLowerCase();
+      if (choice === '2' || choice === '/paste') {
+        const pasted = await ask(t.menuPaste);
+        return { pasteText: pasted.trim(), exit: false };
+      }
+      if (choice === '4' || choice === '/exit' || choice === 'q' || choice === 'exit') {
+        return { pasteText: '', exit: true };
+      }
+      return { pasteText: '', exit: false };
+    }
+  }
+}
+
 function getFallbackSteps(reason, match) {
   if (reason === '1') {
     return [
@@ -607,16 +736,21 @@ function getFallbackSteps(reason, match) {
 }
 
 async function run() {
+  await chooseLanguageIfNeeded();
   if (!QUIET_MODE) {
     console.log(chalk.cyan.bold('\nClawKit Doctor'));
     console.log(chalk.gray(`v${pkg.version}  •  @branzoom (GitHub)`));
     console.log(chalk.gray(`${t.subtitle}\n`));
   }
 
+  const menuState = await runWelcomeMenu(CLI_PASTE_TEXT);
+  if (menuState.exit) return;
+  const pasteText = menuState.pasteText;
+
   let shouldContinueToFull = FULL_MODE;
-  if (PASTE_TEXT) {
-    const match = diagnosePastedError(PASTE_TEXT);
-    report.pastedError = { input: PASTE_TEXT.slice(0, 600), matchId: match?.id || null };
+  if (pasteText) {
+    const match = diagnosePastedError(pasteText);
+    report.pastedError = { input: pasteText.slice(0, 600), matchId: match?.id || null };
 
     if (JSON_MODE) {
       report.pasteDiagnosis = match

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clawkit-doctor",
-  "version": "2.2.0",
+  "version": "3.0.0",
   "description": "Guided OpenClaw diagnostic CLI with issue-first recovery flow",
   "main": "bin/index.js",
   "bin": {
@@ -20,7 +20,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/branzoom/getclawkit-web.git",
+    "url": "git+https://github.com/branzoom/getclawkit-web.git",
     "directory": "packages/clawkit-doctor"
   },
   "homepage": "https://getclawkit.com/tools/doctor",