cli-jaw 2.0.5 → 2.0.6

package/public/js/ui.ts

@@ -40,6 +40,7 @@ import {
     buildProcessBlockHtml,
     getStoredProcessStepDetail,
     mergeStoredProcessStepDetail,
+    setStoredProcessStepDetail,
     processStepMetaFromStore,
     releaseProcessBlockDetails,
     type ProcessStep,
@@ -105,22 +106,22 @@ export function showProcessStep(step: ProcessStep): void {
     if (state.currentProcessBlock) {
         const rawIcon = step.rawIcon || step.icon;
         // Completion detection: prefer semantic status field, fall back to emoji check
-        const resolvedStatus = (step.status && step.status !== 'running')
-            ? step.status
-            : emojiToStatus(step.icon);
+        const resolvedStatus = step.status || emojiToStatus(step.icon) || 'running';
         if (resolvedStatus === 'done' || resolvedStatus === 'error') {
             // Prefer matching by stepRef (stable correlation), fall back to label
             const match = findRunningProcessStepMatch(state.currentProcessBlock.steps, step);
             if (match) {
                 step.icon = emojiToIcon(step.icon);
-                const mergedPreview = mergeStoredProcessStepDetail(match.id, step.detail);
+                const detailPreview = step.type === 'thinking'
+                    ? setStoredProcessStepDetail(match.id, step.detail)
+                    : mergeStoredProcessStepDetail(match.id, step.detail);
                 replaceStep(state.currentProcessBlock, match.id, {
                     ...match,
                     ...step,
                     id: match.id,
                     rawIcon,
-                    detail: mergedPreview,
-                    detailPreview: mergedPreview,
+                    detail: detailPreview,
+                    detailPreview,
                     label: step.label || match.label,
                     status: resolvedStatus,
                 });
@@ -132,19 +133,44 @@ export function showProcessStep(step: ProcessStep): void {
                     .find(s => s.stepRef === step.stepRef && (s.status === 'done' || s.status === 'error'));
                 if (existingDone) {
                     step.icon = emojiToIcon(step.icon);
+                    const detailPreview = step.type === 'thinking'
+                        ? setStoredProcessStepDetail(existingDone.id, step.detail)
+                        : mergeStoredProcessStepDetail(existingDone.id, step.detail);
                     replaceStep(state.currentProcessBlock, existingDone.id, {
                         ...existingDone,
                         ...step,
                         id: existingDone.id,
                         rawIcon,
                         status: resolvedStatus,
-                        detail: mergeStoredProcessStepDetail(existingDone.id, step.detail),
+                        detail: detailPreview,
+                        detailPreview,
                     });
                     scrollToBottom();
                     return;
                 }
             }
         }
+        if (step.stepRef && resolvedStatus === 'running') {
+            const existingRunning = [...state.currentProcessBlock.steps].reverse()
+                .find(s => s.stepRef === step.stepRef && s.status === 'running');
+            if (existingRunning) {
+                step.rawIcon = rawIcon;
+                step.icon = emojiToIcon(step.icon);
+                const detailPreview = setStoredProcessStepDetail(existingRunning.id, step.detail);
+                replaceStep(state.currentProcessBlock, existingRunning.id, {
+                    ...existingRunning,
+                    ...step,
+                    id: existingRunning.id,
+                    rawIcon,
+                    status: 'running',
+                    detail: detailPreview,
+                    detailPreview,
+                    label: step.label || existingRunning.label,
+                });
+                scrollToBottom();
+                return;
+            }
+        }
         // Dedupe: detail이 있는 재broadcast → 같은 label+type의 detail 없는 유령 교체
         if (step.detail) {
             const ghost = [...state.currentProcessBlock.steps].reverse()

package/public/js/ws.ts

@@ -405,7 +405,11 @@ export function connect(): void {
         } else if (msg.type === 'agent_output') {
             appendAgentText(msg.text || '');
         } else if (msg.type === 'agent_retry') {
-            addSystemMsg(t('ws.retry', { cli: escapeHtml(msg.cli || ''), delay: msg.delay || 10 }), 'tool-activity');
+            const retryDelay = Number(msg.delay ?? 0);
+            const retryReasonValue = (msg as WsMessage & { reason?: unknown }).reason;
+            const retryReason = escapeHtml(String(retryReasonValue || '429'));
+            const retryKey = retryDelay > 0 ? 'ws.retry' : 'ws.retryNow';
+            addSystemMsg(t(retryKey, { cli: escapeHtml(msg.cli || ''), reason: retryReason, delay: retryDelay }), 'tool-activity');
         } else if (msg.type === 'agent_fallback') {
             addSystemMsg(t('ws.fallback', { from: escapeHtml(msg.from || ''), to: escapeHtml(msg.to || '') }), 'tool-activity');
         } else if (msg.type === 'agent_smoke') {

package/public/locales/en.json

@@ -91,7 +91,8 @@
     "ws.roundNext": "Round {round} → next round",
     "ws.roundRetry": "Round {round} → retry",
     "ws.fallback": "{from} failed → retrying with {to}",
-    "ws.retry": "{cli} 429 → retrying in {delay}s",
+    "ws.retry": "{cli} {reason} → retrying in {delay}s",
+    "ws.retryNow": "{cli} {reason} → retrying",
     "ws.disconnected": "Disconnected — reconnecting...",
     "tg.settingsUnsupported": "Settings changes are not supported on Telegram.",
     "dc.settingsUnsupported": "Settings changes are not supported on Discord.",
@@ -103,6 +104,11 @@
     "tg.voiceFail": "Voice transcription failed: {msg}",
     "tg.voiceEmpty": "Couldn't understand the voice message. Please try again.",
     "voice.start": "Record voice",
+    "voice.requesting": "Requesting microphone",
+    "voice.requestTimeout": "The microphone permission prompt did not open. Check browser and macOS microphone permissions for this address ({origin}), then try again.",
+    "voice.requestTimeoutLoopback": "The microphone permission prompt did not open. Chrome stores localhost and 127.0.0.1 permissions separately. Allow the current address ({origin}) or open {alternateOrigin}, then try again.",
+    "voice.policyBlocked": "This view cannot use the microphone because of the browser permissions policy. Refresh Manager preview or open it in a new tab.",
+    "voice.permissionDeniedBrowser": "Chrome has blocked microphone access for this address: {origin}. Allow the microphone from the address-bar permissions icon, or enable Chrome microphone access in macOS System Settings.",
     "voice.stop": "Stop recording",
     "voice.micDenied": "Microphone access denied. Please allow microphone in browser settings.",
     "voice.micNotFound": "No microphone found. Please connect a microphone.",
@@ -124,7 +130,7 @@
     "stt.save": "Save STT Settings",
     "stt.saved": "Saved",
     "stt.key.savedPlaceholder": "✓ Saved ····{last4}",
-    "stt.shortcutHint": "Ctrl+Shift+Space (⌘+Shift+Space on Mac)",
+    "stt.shortcutHint": "Ctrl+Shift+Space (⌘+Shift+Space on Mac) · Alt/Option+M",
     "stt.openaiBaseUrl": "Base URL",
     "stt.openaiKey": "API Key",
     "stt.openaiModel": "Model",
@@ -206,6 +212,7 @@
     "settings.none": "(none)",
     "cli.gemini.auth": "Browser auth on first run",
     "cli.copilot.authHint": "copilot login or gh auth login",
+    "cli.showMore": "More ▸",
     "cli.authRequired": "Install / auth required",
     "cli.notAuthenticated": "Auth required — run command below",
     "drag.drop": "Drop files here",
@@ -390,8 +397,16 @@
     "help.telegram.effect": "Allowed Telegram chats can exchange messages, files, voice input, and task results.",
     "help.telegram.use.1": "You want cli-jaw updates through Telegram",
     "help.telegram.use.2": "Web responses should be forwarded to Telegram",
-    "help.telegram.howTo.1": "Configure the bot token and allowed chat ID.",
-    "help.telegram.howTo.2": "Enable mention-only or forwarding options when needed.",
+    "help.telegram.link.botfather": "Create bot with BotFather",
+    "help.telegram.link.docs": "Telegram Bot API guide",
+    "help.telegram.howTo.1": "Open Telegram and search for @BotFather to start a conversation.",
+    "help.telegram.howTo.2": "Send /newbot — it will ask for a display name. Enter one (e.g. \"Jaw Bot\").",
+    "help.telegram.howTo.3": "Next, enter a username. It must end with _bot (e.g. jaw_helper_bot).",
+    "help.telegram.howTo.4": "BotFather will send you an HTTP API token (format: 1234567890:ABCdef...). Copy it.",
+    "help.telegram.howTo.5": "Open ~/.cli-jaw/settings.json and paste the token into telegram.token.",
+    "help.telegram.howTo.6": "Search for your new bot in Telegram → tap \"Start\" or send any message (e.g. \"hello\").",
+    "help.telegram.howTo.7": "Run jaw doctor in your terminal — it will display the chat ID (a number) from the message you just sent.",
+    "help.telegram.howTo.8": "Add that chat ID to the telegram.allowedChatIds array in settings.json — done!",
     "help.telegram.example.1": "Receive a long-running task's finished file through Telegram while away from the web UI.",
     "help.telegram.avoid.1": "Discord is the active operational channel",
     "help.telegram.related.1": "/forward",
@@ -402,8 +417,17 @@
     "help.discord.effect": "Commands, files, and employee results are limited to the configured guild and channel.",
     "help.discord.use.1": "Operating through a server channel with slash commands",
     "help.discord.use.2": "Restricting output to specific guilds or channels",
-    "help.discord.howTo.1": "Set guild and channel routing in Discord settings.",
-    "help.discord.howTo.2": "Run jaw doctor when bot state or permissions look wrong.",
+    "help.discord.link.portal": "Open Discord Developer Portal",
+    "help.discord.link.docs": "Discord bot getting started",
+    "help.discord.howTo.1": "Go to discord.com/developers/applications and log in with your Discord account.",
+    "help.discord.howTo.2": "Click \"New Application\" (top right) → enter an app name (e.g. \"Jaw Bot\") → Create.",
+    "help.discord.howTo.3": "In the left menu, go to \"Bot\" tab → click \"Reset Token\" → copy the bot token. (It's only shown once — save it now!)",
+    "help.discord.howTo.4": "On the same Bot page, scroll to \"Privileged Gateway Intents\" → turn on MESSAGE CONTENT INTENT. (Without this, the bot can't read messages!)",
+    "help.discord.howTo.5": "In the left menu, go to \"OAuth2\" → \"URL Generator\".",
+    "help.discord.howTo.6": "Under SCOPES, check bot and applications.commands. Under BOT PERMISSIONS, select Send Messages, Read Message History, etc.",
+    "help.discord.howTo.7": "Copy the generated invite URL at the bottom → paste in browser → select the server to add the bot to.",
+    "help.discord.howTo.8": "Open ~/.cli-jaw/settings.json and enter discord.token, guildId (server ID), and channelId (channel ID).",
+    "help.discord.howTo.9": "Run jaw doctor in your terminal to verify bot connection and permissions — done!",
     "help.discord.example.1": "Collect employee verification results in one project channel.",
     "help.discord.avoid.1": "You expect direct-message delivery",
     "help.discord.related.1": "jaw doctor",
@@ -528,7 +552,7 @@
     "help.keyboardShortcuts.use.1": "You want to run frequent actions without the mouse",
     "help.keyboardShortcuts.use.2": "You need to know whether shortcuts interrupt typing",
     "help.keyboardShortcuts.use.3": "You are looking for Manager dashboard shortcut settings",
-    "help.keyboardShortcuts.howTo.1": "Classic Web: Enter sends from the chat input, Shift+Enter adds a new line, and slash commands start with / in the same input.",
+    "help.keyboardShortcuts.howTo.1": "Classic Web: Enter sends from the chat input, Shift+Enter adds a new line, slash commands start with / in the same input, and STT recording toggles with Ctrl+Shift+Space or Alt/Option+M.",
     "help.keyboardShortcuts.howTo.2": "Manager: ? opens shortcut help outside editors; Alt+I, Alt+P, and Alt+N jump to Instances, the active Preview, and Notes; Alt+K and Alt+J select the previous or next instance.",
     "help.keyboardShortcuts.howTo.3": "Manager Notes: Cmd/Ctrl+S saves, Cmd/Ctrl+E cycles Raw/Preview/WYSIWYG, Cmd/Ctrl+Shift+F opens note search, Cmd/Ctrl+P toggles the quick switcher, and Cmd/Ctrl+Delete or Cmd/Ctrl+Backspace trashes the selected note or folder.",
     "help.keyboardShortcuts.example.1": "Press Enter in the chat input to send; use Shift+Enter when you need a new line.",

package/public/locales/ja.json

@@ -89,7 +89,8 @@
     "ws.roundNext": "ラウンド {round} → 次のラウンド",
     "ws.roundRetry": "ラウンド {round} → 再試行",
     "ws.fallback": "{from} が失敗 → {to} で再試行しています",
-    "ws.retry": "{cli} が 429 を返しました → {delay}s 後に再試行",
+    "ws.retry": "{cli} {reason} → {delay}s 後に再試行",
+    "ws.retryNow": "{cli} {reason} → 再試行",
     "ws.disconnected": "接続が切れました — 再接続中...",
     "tg.settingsUnsupported": "Telegram では設定変更に対応していません。",
     "dc.settingsUnsupported": "Discord では設定変更に対応していません。",
@@ -101,6 +102,11 @@
     "tg.voiceFail": "音声文字起こしに失敗しました: {msg}",
     "tg.voiceEmpty": "音声を認識できませんでした。もう一度お試しください。",
     "voice.start": "録音",
+    "voice.requesting": "マイク権限を確認中",
+    "voice.requestTimeout": "マイク権限のダイアログが開きませんでした。このアドレス（{origin}）のブラウザと macOS のマイク権限を確認してから、もう一度試してください。",
+    "voice.requestTimeoutLoopback": "マイク権限のダイアログが開きませんでした。Chrome は localhost と 127.0.0.1 の権限を別々に保存します。現在のアドレス（{origin}）を許可するか、{alternateOrigin} を開いてもう一度試してください。",
+    "voice.policyBlocked": "この画面はブラウザーの権限ポリシーによりマイクを使用できません。Manager preview を再読み込みするか、新しいタブで開いてください。",
+    "voice.permissionDeniedBrowser": "Chrome でこのアドレスのマイク権限がブロックされています: {origin}。アドレスバー左側の権限アイコンでマイクを許可するか、macOS のシステム設定で Chrome のマイク権限を有効にしてください。",
     "voice.stop": "録音を停止",
     "voice.micDenied": "マイクへのアクセスが拒否されました。ブラウザ設定でマイクを許可してください。",
     "voice.micNotFound": "マイクが見つかりません。マイクを接続してください。",
@@ -122,7 +128,7 @@
     "stt.save": "STT 設定を保存",
     "stt.saved": "保存しました",
     "stt.key.savedPlaceholder": "✓ 入力済み ····{last4}",
-    "stt.shortcutHint": "Ctrl+Shift+Space（Mac では ⌘+Shift+Space）",
+    "stt.shortcutHint": "Ctrl+Shift+Space（Mac では ⌘+Shift+Space） · Alt/Option+M",
     "stt.openaiBaseUrl": "ベース URL",
     "stt.openaiKey": "API キー",
     "stt.openaiModel": "モデル",
@@ -204,6 +210,7 @@
     "settings.none": "（なし）",
     "cli.gemini.auth": "初回実行時にブラウザ認証",
     "cli.copilot.authHint": "copilot login または gh auth login",
+    "cli.showMore": "もっと見る ▸",
     "cli.authRequired": "インストール/認証が必要です",
     "cli.notAuthenticated": "認証が必要です — 下のコマンドを実行してください",
     "drag.drop": "ここにファイルをドロップ",
@@ -388,8 +395,16 @@
     "help.telegram.effect": "許可された Telegram チャットで、メッセージ、ファイル、音声入力、タスク結果をやり取りできます。",
     "help.telegram.use.1": "Telegram で cli-jaw の更新を受け取りたいとき",
     "help.telegram.use.2": "Web の応答を Telegram に転送したいとき",
-    "help.telegram.howTo.1": "bot token と許可する chat ID を設定します。",
-    "help.telegram.howTo.2": "必要に応じて mention-only や forwarding オプションを有効にします。",
+    "help.telegram.link.botfather": "BotFatherでbot作成",
+    "help.telegram.link.docs": "Telegram Bot APIガイド",
+    "help.telegram.howTo.1": "Telegram アプリで @BotFather を検索して会話を開始します。",
+    "help.telegram.howTo.2": "/newbot を送信すると bot 名を聞かれます。表示名を入力してください（例: \"Jaw Bot\"）。",
+    "help.telegram.howTo.3": "次にユーザー名を入力します。必ず _bot で終わる必要があります（例: jaw_helper_bot）。",
+    "help.telegram.howTo.4": "成功すると BotFather が HTTP API token を送ってきます（1234567890:ABCdef... 形式）。これをコピーしてください。",
+    "help.telegram.howTo.5": "~/.cli-jaw/settings.json を開き、telegram.token にコピーした token を貼り付けます。",
+    "help.telegram.howTo.6": "Telegram で作成した bot を検索 →「開始」をタップするか、何かメッセージ（例: \"hello\"）を送ります。",
+    "help.telegram.howTo.7": "ターミナルで jaw doctor を実行すると、送信したチャットの chat ID（数字）が表示されます。",
+    "help.telegram.howTo.8": "settings.json の telegram.allowedChatIds 配列にその chat ID を追加すれば設定完了！",
     "help.telegram.example.1": "Web から離れていても、長時間タスクの完了ファイルを Telegram で受け取れます。",
     "help.telegram.avoid.1": "Discord が現在の運用チャンネルである場合",
     "help.telegram.related.1": "/forward コマンド",
@@ -400,8 +415,17 @@
     "help.discord.effect": "コマンド、ファイル、従業員結果は、設定した guild と channel に制限されます。",
     "help.discord.use.1": "サーバーチャンネルでスラッシュコマンド中心に運用するとき",
     "help.discord.use.2": "出力先を特定の guild や channel に制限したいとき",
-    "help.discord.howTo.1": "Discord 設定で guild と channel のルーティングを設定します。",
-    "help.discord.howTo.2": "bot の状態や権限に問題がありそうな場合は jaw doctor を実行します。",
+    "help.discord.link.portal": "Discord Developer Portalを開く",
+    "help.discord.link.docs": "Discord botスタートガイド",
+    "help.discord.howTo.1": "discord.com/developers/applications にアクセスし、Discord アカウントでログインします。",
+    "help.discord.howTo.2": "右上の「New Application」をクリック → アプリ名を入力（例: \"Jaw Bot\"）→ Create。",
+    "help.discord.howTo.3": "左メニュー「Bot」タブ →「Reset Token」をクリック → bot token をコピーします。（一度しか表示されないのですぐ保存！）",
+    "help.discord.howTo.4": "同じ Bot ページ下部「Privileged Gateway Intents」→ MESSAGE CONTENT INTENT を有効にします。（これがないとメッセージを読めません！）",
+    "help.discord.howTo.5": "左メニュー「OAuth2」→「URL Generator」に移動します。",
+    "help.discord.howTo.6": "SCOPES で bot と applications.commands をチェック。下の BOT PERMISSIONS で Send Messages、Read Message History などを選択します。",
+    "help.discord.howTo.7": "ページ下部に生成された招待 URL をコピー → ブラウザに貼り付け → bot を追加するサーバーを選択します。",
+    "help.discord.howTo.8": "~/.cli-jaw/settings.json に discord.token、guildId（サーバー ID）、channelId（チャンネル ID）を入力します。",
+    "help.discord.howTo.9": "ターミナルで jaw doctor を実行して bot 接続と権限が正常か確認すれば完了！",
     "help.discord.example.1": "従業員の検証結果を 1 つのプロジェクトチャンネルに集約できます。",
     "help.discord.avoid.1": "DM での配信を期待している場合",
     "help.discord.related.1": "jaw doctor コマンド",
@@ -526,7 +550,7 @@
     "help.keyboardShortcuts.use.1": "マウスなしでよく使う操作を実行したいとき",
     "help.keyboardShortcuts.use.2": "ショートカットが入力を邪魔しないか確認したいとき",
     "help.keyboardShortcuts.use.3": "Manager dashboard のショートカット設定を探しているとき",
-    "help.keyboardShortcuts.howTo.1": "Classic Web: チャット入力では Enter で送信し、Shift+Enter で改行します。スラッシュコマンドは同じ入力欄で / から始めます。",
+    "help.keyboardShortcuts.howTo.1": "Classic Web: チャット入力では Enter で送信し、Shift+Enter で改行します。スラッシュコマンドは同じ入力欄で / から始めます。STT 録音は Ctrl+Shift+Space または Alt/Option+M で切り替えます。",
     "help.keyboardShortcuts.howTo.2": "Manager: エディタ外では ? でショートカットヘルプを開き、Alt+I、Alt+P、Alt+N で Instances、active Preview、Notes へ移動し、Alt+K と Alt+J で前後のインスタンスを選択します。",
     "help.keyboardShortcuts.howTo.3": "Manager Notes: Cmd/Ctrl+S で保存、Cmd/Ctrl+E で Raw/Preview/WYSIWYG を切り替え、Cmd/Ctrl+Shift+F でノート検索、Cmd/Ctrl+P で quick switcher、Cmd/Ctrl+Delete または Cmd/Ctrl+Backspace で選択中のノートやフォルダをゴミ箱へ移動します。",
     "help.keyboardShortcuts.example.1": "チャット入力で Enter を押すと送信し、改行したいときは Shift+Enter を使います。",

package/public/locales/ko.json

@@ -91,7 +91,8 @@
     "ws.roundNext": "라운드 {round} → 다음 라운드",
     "ws.roundRetry": "라운드 {round} → 재시도",
     "ws.fallback": "{from} 실패 → {to}로 재시도",
-    "ws.retry": "{cli} 429 → {delay}s 후 재시도",
+    "ws.retry": "{cli} {reason} → {delay}s 후 재시도",
+    "ws.retryNow": "{cli} {reason} → 재시도",
     "ws.disconnected": "연결 끊김 — 재연결 중...",
     "tg.settingsUnsupported": "Telegram에서 설정 변경은 지원하지 않습니다.",
     "dc.settingsUnsupported": "Discord에서 설정 변경은 지원하지 않습니다.",
@@ -103,6 +104,11 @@
     "tg.voiceFail": "음성 인식 실패: {msg}",
     "tg.voiceEmpty": "음성을 인식하지 못했어요. 다시 시도해주세요.",
     "voice.start": "음성 녹음",
+    "voice.requesting": "마이크 권한 확인 중",
+    "voice.requestTimeout": "마이크 권한 창이 열리지 않았어요. 현재 주소({origin})의 브라우저와 macOS 마이크 권한을 확인한 뒤 다시 눌러 주세요.",
+    "voice.requestTimeoutLoopback": "마이크 권한 창이 열리지 않았어요. Chrome은 localhost와 127.0.0.1 권한을 따로 저장합니다. 현재 주소({origin})를 허용하거나 {alternateOrigin}로 열어 다시 눌러 주세요.",
+    "voice.policyBlocked": "이 화면은 브라우저 권한 정책 때문에 마이크를 사용할 수 없어요. Manager preview를 새로고침하거나 새 탭에서 열어 주세요.",
+    "voice.permissionDeniedBrowser": "Chrome에서 이 주소의 마이크 권한이 차단되어 있어요: {origin}. 주소창 왼쪽 권한 아이콘에서 마이크를 허용하거나 macOS 시스템 설정에서 Chrome 마이크 권한을 켜 주세요.",
     "voice.stop": "녹음 중지",
     "voice.micDenied": "마이크 접근이 거부됐어요. 브라우저 설정에서 마이크를 허용해 주세요.",
     "voice.micNotFound": "마이크를 찾을 수 없어요. 마이크를 연결해 주세요.",
@@ -124,7 +130,7 @@
     "stt.save": "STT 설정 저장",
     "stt.saved": "저장됨",
     "stt.key.savedPlaceholder": "✓ 입력됨 ····{last4}",
-    "stt.shortcutHint": "Ctrl+Shift+Space (Mac: ⌘+Shift+Space)",
+    "stt.shortcutHint": "Ctrl+Shift+Space (Mac: ⌘+Shift+Space) · Alt/Option+M",
     "stt.openaiBaseUrl": "Base URL",
     "stt.openaiKey": "API Key",
     "stt.openaiModel": "모델",
@@ -206,6 +212,7 @@
     "settings.none": "(없음)",
     "cli.gemini.auth": "첫 실행 시 브라우저 인증",
     "cli.copilot.authHint": "copilot login 또는 gh auth login",
+    "cli.showMore": "더 보기 ▸",
     "cli.authRequired": "설치 / 인증 필요",
     "cli.notAuthenticated": "인증 필요 — 아래 명령어 실행",
     "drag.drop": "파일을 여기에 드랍하세요",
@@ -390,8 +397,16 @@
     "help.telegram.effect": "허용된 Telegram 채팅에서 메시지, 파일, 음성 입력, 작업 결과를 주고받을 수 있습니다.",
     "help.telegram.use.1": "Telegram에서 cli-jaw 응답이나 상태를 받고 싶을 때",
     "help.telegram.use.2": "웹 응답을 Telegram으로 자동 전송할 때",
-    "help.telegram.howTo.1": "Bot token과 allowed chat ID를 설정합니다.",
-    "help.telegram.howTo.2": "필요하면 mention-only나 forwarding 옵션을 켭니다.",
+    "help.telegram.link.botfather": "BotFather에서 봇 만들기",
+    "help.telegram.link.docs": "Telegram Bot API 가이드",
+    "help.telegram.howTo.1": "Telegram 앱에서 @BotFather를 검색해서 대화를 시작합니다.",
+    "help.telegram.howTo.2": "/newbot 명령을 보내면 봇 이름을 물어봅니다. 표시될 이름을 입력하세요 (예: \"Jaw Bot\").",
+    "help.telegram.howTo.3": "다음으로 유저네임을 입력합니다. 반드시 _bot으로 끝나야 해요 (예: jaw_helper_bot).",
+    "help.telegram.howTo.4": "성공하면 BotFather가 HTTP API 토큰을 보내줍니다 (1234567890:ABCdef... 형식). 이 토큰을 복사하세요.",
+    "help.telegram.howTo.5": "~/.cli-jaw/settings.json을 열고 telegram.token에 복사한 토큰을 붙여넣습니다.",
+    "help.telegram.howTo.6": "Telegram에서 방금 만든 봇을 검색 → \"시작\" 버튼을 누르거나 아무 메시지(예: \"hello\")를 보냅니다.",
+    "help.telegram.howTo.7": "터미널에서 jaw doctor를 실행하면 방금 보낸 채팅의 chat ID(숫자)가 표시됩니다.",
+    "help.telegram.howTo.8": "settings.json의 telegram.allowedChatIds 배열에 이 chat ID를 추가하면 설정 완료!",
     "help.telegram.example.1": "외출 중에도 Telegram으로 장기 작업 완료 파일을 받을 수 있습니다.",
     "help.telegram.avoid.1": "Discord를 주 운영 채널로 쓰는 경우",
     "help.telegram.related.1": "/forward",
@@ -402,8 +417,17 @@
     "help.discord.effect": "설정된 guild와 channel로 명령, 파일, 직원 결과 전달 범위가 제한됩니다.",
     "help.discord.use.1": "서버 채널에서 slash command 중심으로 운영할 때",
     "help.discord.use.2": "특정 guild/channel로 출력을 제한할 때",
-    "help.discord.howTo.1": "Discord 설정에서 guild와 channel 라우팅을 지정합니다.",
-    "help.discord.howTo.2": "문제가 있으면 jaw doctor로 bot 상태와 권한을 확인합니다.",
+    "help.discord.link.portal": "Discord Developer Portal 열기",
+    "help.discord.link.docs": "Discord 봇 시작 가이드",
+    "help.discord.howTo.1": "discord.com/developers/applications에 접속하고 Discord 계정으로 로그인합니다.",
+    "help.discord.howTo.2": "오른쪽 상단 \"New Application\" 클릭 → 앱 이름 입력 (예: \"Jaw Bot\") → Create.",
+    "help.discord.howTo.3": "왼쪽 메뉴 \"Bot\" 탭 → \"Reset Token\" 클릭 → 봇 토큰을 복사합니다. (한 번만 보이니 바로 저장하세요!)",
+    "help.discord.howTo.4": "같은 Bot 페이지 아래쪽 \"Privileged Gateway Intents\" → MESSAGE CONTENT INTENT를 켭니다. (안 켜면 메시지를 못 읽어요!)",
+    "help.discord.howTo.5": "왼쪽 메뉴 \"OAuth2\" → \"URL Generator\"로 이동합니다.",
+    "help.discord.howTo.6": "SCOPES에서 bot과 applications.commands를 체크합니다. 아래 BOT PERMISSIONS에서 Send Messages, Read Message History 등을 선택합니다.",
+    "help.discord.howTo.7": "페이지 하단에 생성된 초대 URL을 복사 → 브라우저에 붙여넣기 → 봇을 추가할 서버를 선택합니다.",
+    "help.discord.howTo.8": "~/.cli-jaw/settings.json에 discord.token, guildId(서버 ID), channelId(채널 ID)를 입력합니다.",
+    "help.discord.howTo.9": "터미널에서 jaw doctor를 실행해서 봇 연결 상태와 권한이 정상인지 확인하면 완료!",
     "help.discord.example.1": "프로젝트 채널 하나에 직원 검증 결과만 모아볼 수 있습니다.",
     "help.discord.avoid.1": "DM 전달을 기대하는 경우",
     "help.discord.related.1": "jaw doctor",
@@ -528,7 +552,7 @@
     "help.keyboardShortcuts.use.1": "마우스 없이 자주 쓰는 동작을 실행하고 싶을 때",
     "help.keyboardShortcuts.use.2": "단축키가 입력창을 방해하는지 확인하고 싶을 때",
     "help.keyboardShortcuts.use.3": "Manager dashboard 단축키 설정 위치를 찾을 때",
-    "help.keyboardShortcuts.howTo.1": "Classic Web: 채팅 입력창에서 Enter는 전송, Shift+Enter는 줄바꿈이며, 슬래시 커맨드는 같은 입력창에서 /로 시작합니다.",
+    "help.keyboardShortcuts.howTo.1": "Classic Web: 채팅 입력창에서 Enter는 전송, Shift+Enter는 줄바꿈이며, 슬래시 커맨드는 같은 입력창에서 /로 시작합니다. STT 녹음은 Ctrl+Shift+Space 또는 Alt/Option+M으로 토글합니다.",
     "help.keyboardShortcuts.howTo.2": "Manager: 에디터 밖에서 ?는 단축키 도움말을 열고, Alt+I, Alt+P, Alt+N은 Instances, active Preview, Notes로 이동하며, Alt+K와 Alt+J는 이전/다음 인스턴스를 선택합니다.",
     "help.keyboardShortcuts.howTo.3": "Manager Notes: Cmd/Ctrl+S는 저장, Cmd/Ctrl+E는 Raw/Preview/WYSIWYG 전환, Cmd/Ctrl+Shift+F는 노트 검색, Cmd/Ctrl+P는 quick switcher 토글, Cmd/Ctrl+Delete 또는 Cmd/Ctrl+Backspace는 선택한 노트나 폴더를 휴지통으로 보냅니다.",
     "help.keyboardShortcuts.example.1": "채팅 입력창에서 Enter를 눌러 전송하고, 줄바꿈이 필요하면 Shift+Enter를 사용합니다.",

package/public/locales/zh.json

@@ -89,7 +89,8 @@
     "ws.roundNext": "第 {round} 轮 → 下一轮",
     "ws.roundRetry": "第 {round} 轮 → 重试",
     "ws.fallback": "{from} 失败 → 正在改用 {to} 重试",
-    "ws.retry": "{cli} 返回 429 → {delay}s 后重试",
+    "ws.retry": "{cli} {reason} → {delay}s 后重试",
+    "ws.retryNow": "{cli} {reason} → 重试",
     "ws.disconnected": "连接已断开 — 正在重连...",
     "tg.settingsUnsupported": "Telegram 不支持修改设置。",
     "dc.settingsUnsupported": "Discord 不支持修改设置。",
@@ -101,6 +102,11 @@
     "tg.voiceFail": "语音转写失败：{msg}",
     "tg.voiceEmpty": "没有听清语音内容。请再试一次。",
     "voice.start": "录音",
+    "voice.requesting": "正在请求麦克风",
+    "voice.requestTimeout": "麦克风权限提示未打开。请检查此地址（{origin}）的浏览器和 macOS 麦克风权限后重试。",
+    "voice.requestTimeoutLoopback": "麦克风权限提示未打开。Chrome 会分别保存 localhost 和 127.0.0.1 的权限。请允许当前地址（{origin}），或打开 {alternateOrigin} 后重试。",
+    "voice.policyBlocked": "此视图因浏览器权限策略无法使用麦克风。请刷新 Manager preview，或在新标签页中打开。",
+    "voice.permissionDeniedBrowser": "Chrome 已阻止此地址的麦克风权限：{origin}。请在地址栏左侧的权限图标中允许麦克风，或在 macOS 系统设置中启用 Chrome 的麦克风权限。",
     "voice.stop": "停止录音",
     "voice.micDenied": "麦克风访问被拒绝。请在浏览器设置中允许麦克风权限。",
     "voice.micNotFound": "没有找到麦克风。请连接麦克风。",
@@ -122,7 +128,7 @@
     "stt.save": "保存 STT 设置",
     "stt.saved": "已保存",
     "stt.key.savedPlaceholder": "✓ 已输入 ····{last4}",
-    "stt.shortcutHint": "Ctrl+Shift+Space（Mac 上为 ⌘+Shift+Space）",
+    "stt.shortcutHint": "Ctrl+Shift+Space（Mac 上为 ⌘+Shift+Space） · Alt/Option+M",
     "stt.openaiBaseUrl": "Base URL（基础地址）",
     "stt.openaiKey": "API 密钥",
     "stt.openaiModel": "模型",
@@ -204,6 +210,7 @@
     "settings.none": "（无）",
     "cli.gemini.auth": "首次运行时通过浏览器认证",
     "cli.copilot.authHint": "copilot login 或 gh auth login",
+    "cli.showMore": "更多 ▸",
     "cli.authRequired": "需要安装/认证",
     "cli.notAuthenticated": "需要认证 — 请运行下面的命令",
     "drag.drop": "将文件拖到这里",
@@ -388,8 +395,16 @@
     "help.telegram.effect": "允许的 Telegram 聊天可以收发消息、文件、语音输入和任务结果。",
     "help.telegram.use.1": "希望通过 Telegram 接收 cli-jaw 更新时",
     "help.telegram.use.2": "希望把 Web 回复转发到 Telegram 时",
-    "help.telegram.howTo.1": "配置 bot token 和允许的 chat ID。",
-    "help.telegram.howTo.2": "需要时启用 mention-only 或 forwarding 选项。",
+    "help.telegram.link.botfather": "用 BotFather 创建 bot",
+    "help.telegram.link.docs": "Telegram Bot API 指南",
+    "help.telegram.howTo.1": "Telegram 应用中搜索 @BotFather 并开始对话。",
+    "help.telegram.howTo.2": "发送 /newbot，它会询问显示名称。输入一个名字（例如 \"Jaw Bot\"）。",
+    "help.telegram.howTo.3": "接着输入用户名，必须以 _bot 结尾（例如 jaw_helper_bot）。",
+    "help.telegram.howTo.4": "成功后 BotFather 会发送 HTTP API token（格式: 1234567890:ABCdef...）。复制它。",
+    "help.telegram.howTo.5": "打开 ~/.cli-jaw/settings.json，将 token 粘贴到 telegram.token 中。",
+    "help.telegram.howTo.6": "在 Telegram 中搜索刚创建的 bot → 点击「开始」或发送任意消息（例如 \"hello\"）。",
+    "help.telegram.howTo.7": "在终端运行 jaw doctor，会显示刚才发送消息的 chat ID（数字）。",
+    "help.telegram.howTo.8": "将该 chat ID 添加到 settings.json 的 telegram.allowedChatIds 数组中，设置完成！",
     "help.telegram.example.1": "离开网页时，也可以通过 Telegram 接收长任务完成后的文件。",
     "help.telegram.avoid.1": "Discord 才是当前运营频道时",
     "help.telegram.related.1": "/forward 命令",
@@ -400,8 +415,17 @@
     "help.discord.effect": "命令、文件和员工结果会限制在配置的 guild 和 channel 内。",
     "help.discord.use.1": "通过服务器频道和斜杠命令运营时",
     "help.discord.use.2": "需要将输出限制到特定 guild 或 channel 时",
-    "help.discord.howTo.1": "在 Discord 设置中填写 guild 和 channel 路由。",
-    "help.discord.howTo.2": "bot 状态或权限异常时运行 jaw doctor。",
+    "help.discord.link.portal": "打开 Discord Developer Portal",
+    "help.discord.link.docs": "Discord bot 入门指南",
+    "help.discord.howTo.1": "访问 discord.com/developers/applications 并用 Discord 账号登录。",
+    "help.discord.howTo.2": "点击右上角「New Application」→ 输入应用名（例如 \"Jaw Bot\"）→ Create。",
+    "help.discord.howTo.3": "左侧菜单「Bot」标签 → 点击「Reset Token」→ 复制 bot token。（只显示一次，请立即保存！）",
+    "help.discord.howTo.4": "同一 Bot 页面底部「Privileged Gateway Intents」→ 开启 MESSAGE CONTENT INTENT。（不开的话 bot 无法读取消息！）",
+    "help.discord.howTo.5": "左侧菜单「OAuth2」→「URL Generator」。",
+    "help.discord.howTo.6": "SCOPES 勾选 bot 和 applications.commands。下方 BOT PERMISSIONS 选择 Send Messages、Read Message History 等权限。",
+    "help.discord.howTo.7": "复制页面底部生成的邀请 URL → 粘贴到浏览器 → 选择要添加 bot 的服务器。",
+    "help.discord.howTo.8": "打开 ~/.cli-jaw/settings.json，填写 discord.token、guildId（服务器 ID）、channelId（频道 ID）。",
+    "help.discord.howTo.9": "在终端运行 jaw doctor 确认 bot 连接和权限正常，设置完成！",
     "help.discord.example.1": "把员工验证结果集中到一个项目频道。",
     "help.discord.avoid.1": "你期待通过私信投递时",
     "help.discord.related.1": "jaw doctor 命令",
@@ -526,7 +550,7 @@
     "help.keyboardShortcuts.use.1": "希望不用鼠标执行常用操作时",
     "help.keyboardShortcuts.use.2": "需要确认快捷键是否会打断输入时",
     "help.keyboardShortcuts.use.3": "寻找 Manager dashboard 快捷键设置时",
-    "help.keyboardShortcuts.howTo.1": "Classic Web：在聊天输入框中按 Enter 发送，Shift+Enter 换行，斜杠命令从同一个输入框里的 / 开始。",
+    "help.keyboardShortcuts.howTo.1": "Classic Web：在聊天输入框中按 Enter 发送，Shift+Enter 换行，斜杠命令从同一个输入框里的 / 开始；STT 录音可用 Ctrl+Shift+Space 或 Alt/Option+M 切换。",
     "help.keyboardShortcuts.howTo.2": "Manager：不在编辑器中时，? 打开快捷键帮助；Alt+I、Alt+P、Alt+N 跳到 Instances、active Preview 和 Notes；Alt+K 与 Alt+J 选择上一个或下一个实例。",
     "help.keyboardShortcuts.howTo.3": "Manager Notes：Cmd/Ctrl+S 保存，Cmd/Ctrl+E 在 Raw/Preview/WYSIWYG 间切换，Cmd/Ctrl+Shift+F 打开笔记搜索，Cmd/Ctrl+P 切换 quick switcher，Cmd/Ctrl+Delete 或 Cmd/Ctrl+Backspace 将选中的笔记或文件夹移到废纸篓。",
     "help.keyboardShortcuts.example.1": "在聊天输入框按 Enter 发送；需要换行时使用 Shift+Enter。",

package/public/manager/src/App.tsx

@@ -29,12 +29,13 @@ import { useCommandPalette } from './hooks/useCommandPalette';
 import { useInstanceLabelEditor } from './hooks/useInstanceLabelEditor';
 import { useInstanceMessageEvents } from './hooks/useInstanceMessageEvents';
 import { useManagerEvents } from './hooks/useManagerEvents';
+import { usePreviewSttLifecycle } from './usePreviewSttLifecycle';
+import { usePreviewShortcutMessages } from './usePreviewShortcutMessages';
 import { formatUptime, instanceLabel } from './instance-label';
 import { useJawCeoDashboardBridge } from './jaw-ceo/useJawCeoDashboardBridge';
 import { actionForShortcutEvent, isManagerShortcutEditableTarget } from './manager-shortcuts';
 import { reconcileActiveProfileFilter } from './profile-filter';
 import type { DashboardDetailTab, DashboardInstance, DashboardInstanceStatus, DashboardLifecycleAction, DashboardNotesAuthoringMode, DashboardNotesViewMode, DashboardProfile, DashboardScanResult, DashboardShortcutAction, DashboardSidebarMode } from './types';
-
 export function App() {
     const [data, setData] = useState<DashboardScanResult | null>(null);
     const [loading, setLoading] = useState(true);
@@ -120,6 +121,8 @@ export function App() {
     }, [filtered, instances, view.selectedPort]);
     const activeJawCeoPort = selectedInstance?.port ?? view.selectedPort ?? null;
     const jawCeoBridge = useJawCeoDashboardBridge({ selectedPort: activeJawCeoPort, managerEvents: managerEvents.events, messageEvents: messageActivity.events, onOpenWorker: handleOpenJawCeoWorker });
+    usePreviewSttLifecycle(jawCeoBridge.voice);
+    usePreviewShortcutMessages({ enabled: view.dashboardShortcutsEnabled, keymap: view.dashboardShortcutKeymap, onAction: runManagerShortcut });
     const activePreviewPort = view.activeDetailTab === 'preview' && view.sidebarMode === 'instances'
         ? (selectedInstance?.port ?? null)
         : null;
@@ -316,30 +319,12 @@ export function App() {
         view.setSidebarMode(sidebarMode); void saveUi({ sidebarMode });
     }
 
-    function handleNotesSelectedPathChange(path: string | null): void {
-        view.setNotesSelectedPath(path); void saveUi({ notesSelectedPath: path });
-    }
-
-    function openNotesSidebarSearch(): void {
-        setNotesSidebarMode('search');
-        setNotesSearchFocusToken(token => token + 1);
-    }
-
-    function handleNotesViewModeChange(mode: DashboardNotesViewMode): void {
-        view.setNotesViewMode(mode); void saveUi({ notesViewMode: mode });
-    }
-
-    function handleNotesAuthoringModeChange(mode: DashboardNotesAuthoringMode): void {
-        view.setNotesAuthoringMode(mode); void saveUi({ notesAuthoringMode: mode });
-    }
-
-    function handleNotesWordWrapChange(value: boolean): void {
-        view.setNotesWordWrap(value); void saveUi({ notesWordWrap: value });
-    }
-
-    function handleNotesTreeWidthChange(value: number): void {
-        view.setNotesTreeWidth(value); void saveUi({ notesTreeWidth: value });
-    }
+    function handleNotesSelectedPathChange(path: string | null): void { view.setNotesSelectedPath(path); void saveUi({ notesSelectedPath: path }); }
+    function openNotesSidebarSearch(): void { setNotesSidebarMode('search'); setNotesSearchFocusToken(token => token + 1); }
+    function handleNotesViewModeChange(mode: DashboardNotesViewMode): void { view.setNotesViewMode(mode); void saveUi({ notesViewMode: mode }); }
+    function handleNotesAuthoringModeChange(mode: DashboardNotesAuthoringMode): void { view.setNotesAuthoringMode(mode); void saveUi({ notesAuthoringMode: mode }); }
+    function handleNotesWordWrapChange(value: boolean): void { view.setNotesWordWrap(value); void saveUi({ notesWordWrap: value }); }
+    function handleNotesTreeWidthChange(value: number): void { view.setNotesTreeWidth(value); void saveUi({ notesTreeWidth: value }); }
 
     const notesModel = useNotesModel({
         active: view.sidebarMode === 'notes',
@@ -405,6 +390,14 @@ export function App() {
 
     useEffect(() => {
         function onKeyDown(event: KeyboardEvent): void {
+            if ((event.ctrlKey || event.metaKey) && event.key === 'f') {
+                const frame = document.querySelector<HTMLIFrameElement>('.preview-frame');
+                if (frame?.contentWindow) {
+                    event.preventDefault();
+                    frame.contentWindow.postMessage({ type: 'jaw-preview-search' }, '*');
+                    return;
+                }
+            }
             if (!view.dashboardShortcutsEnabled) return;
             if (isManagerShortcutEditableTarget(event.target)) return;
             const action = actionForShortcutEvent(event, view.dashboardShortcutKeymap);
@@ -414,36 +407,7 @@ export function App() {
         }
         document.addEventListener('keydown', onKeyDown);
         return () => document.removeEventListener('keydown', onKeyDown);
-    }, [
-        filtered,
-        selectedInstance,
-        view.dashboardShortcutsEnabled,
-        view.dashboardShortcutKeymap,
-        view.sidebarMode,
-        view.activeDetailTab,
-        settingsDirty,
-    ]);
-
-    useEffect(() => {
-        function onPreviewShortcut(event: MessageEvent): void {
-            if (!view.dashboardShortcutsEnabled) return;
-            const data = event.data;
-            if (!data || data.type !== 'jaw-preview-shortcut') return;
-            const synth = { key: data.key, altKey: !!data.altKey, ctrlKey: false, metaKey: false, shiftKey: !!data.shiftKey } as unknown as KeyboardEvent;
-            const action = actionForShortcutEvent(synth, view.dashboardShortcutKeymap);
-            if (action) runManagerShortcut(action);
-        }
-        window.addEventListener('message', onPreviewShortcut);
-        return () => window.removeEventListener('message', onPreviewShortcut);
-    }, [
-        filtered,
-        selectedInstance,
-        view.dashboardShortcutsEnabled,
-        view.dashboardShortcutKeymap,
-        view.sidebarMode,
-        view.activeDetailTab,
-        settingsDirty,
-    ]);
+    }, [filtered, selectedInstance, view.dashboardShortcutsEnabled, view.dashboardShortcutKeymap, view.sidebarMode, view.activeDetailTab, settingsDirty]);
 
     async function handleLifecycle(action: DashboardLifecycleAction, instance: DashboardInstance): Promise<void> {
         const lifecycle = instance.lifecycle;