cli-jaw 2.0.3 → 2.0.5

package/public/manager/src/dashboard-settings/DashboardSettingsWorkspace.tsx

@@ -1,12 +1,18 @@
-import { useEffect, type ReactNode } from 'react';
-import type { DashboardLocale, DashboardRegistryUi } from '../types';
+import { Suspense, lazy, useEffect, type ReactNode } from 'react';
+import { formatShortcut, MANAGER_SHORTCUT_ACTIONS } from '../manager-shortcuts';
+
+const LazyEmbedding = lazy(() => import('./DashboardEmbeddingSection').then(m => ({ default: m.DashboardEmbeddingSection })));
+import { HelpTopicButton } from '../help/HelpTopicButton';
+import type { HelpTopicId } from '../help/helpContent';
+import type { DashboardLocale, DashboardRegistryUi, DashboardShortcutAction } from '../types';
 import type { DashboardActivityTitleSupport } from './activity-title-support';
 
 type DashboardSettingsWorkspaceProps = {
-    activeSection: 'display' | 'activity';
+    activeSection: 'display' | 'activity' | 'embedding';
     ui: DashboardRegistryUi;
     titleSupport: DashboardActivityTitleSupport;
     onUiPatch: (patch: Partial<DashboardRegistryUi>) => void;
+    onOpenHelpTopic: (topic: HelpTopicId) => void;
 };
 
 const LOCALE_OPTIONS = [
@@ -30,6 +36,8 @@ const COPY = {
         displayDescription: '이 설정은 왼쪽 인스턴스 목록과 저장된 매니저 UI 환경설정에만 적용됩니다.',
         activityTitle: '미리보기와 활동',
         activityDescription: '최근 작업 제목은 각 인스턴스 서버의 endpoint 버전에 따라 달라집니다.',
+        embeddingTitle: '임베딩 검색',
+        embeddingDescription: '벡터 임베딩 provider를 설정하고 메모리 인덱스를 관리합니다.',
         fields: {
             activity: {
                 label: '최근 작업 미리보기',
@@ -56,6 +64,36 @@ const COPY = {
                 scope: '전체 Jaw UI',
                 description: 'i18n을 지원하는 매니저 대시보드 화면에 사용할 언어를 저장합니다.',
             },
+            shortcuts: {
+                label: '전역 단축키',
+                scope: 'Manager dashboard',
+                description: '입력창과 에디터 바깥에서만 작동하는 Manager 이동 단축키를 켭니다.',
+            },
+            shortcutFocusInstances: {
+                label: '인스턴스 목록',
+                scope: '단축키',
+                description: 'Instances workspace로 이동합니다.',
+            },
+            shortcutFocusActiveSession: {
+                label: '활성 세션',
+                scope: '단축키',
+                description: '선택된 인스턴스의 Preview 탭으로 이동합니다.',
+            },
+            shortcutFocusNotes: {
+                label: '노트',
+                scope: '단축키',
+                description: 'Notes workspace로 이동합니다.',
+            },
+            shortcutPreviousInstance: {
+                label: '이전 인스턴스',
+                scope: '단축키',
+                description: '현재 필터 목록에서 이전 인스턴스를 선택합니다.',
+            },
+            shortcutNextInstance: {
+                label: '다음 인스턴스',
+                scope: '단축키',
+                description: '현재 필터 목록에서 다음 인스턴스를 선택합니다.',
+            },
         },
         support: {
             ariaLabel: '작업 제목 출처 준비 상태',
@@ -74,6 +112,8 @@ const COPY = {
         displayDescription: 'These controls only affect the left instance list and saved manager UI preferences.',
         activityTitle: 'Preview & activity',
         activityDescription: 'Latest activity titles depend on each instance server endpoint version.',
+        embeddingTitle: 'Embedding search',
+        embeddingDescription: 'Configure a vector embedding provider and manage the memory index.',
         fields: {
             activity: {
                 label: 'Recent activity preview',
@@ -100,6 +140,36 @@ const COPY = {
                 scope: 'Global Jaw UI',
                 description: 'Sets the saved manager dashboard locale for i18n-aware surfaces.',
             },
+            shortcuts: {
+                label: 'Global shortcuts',
+                scope: 'Manager dashboard',
+                description: 'Enable Manager navigation shortcuts outside inputs and editors.',
+            },
+            shortcutFocusInstances: {
+                label: 'Instance list',
+                scope: 'Shortcut',
+                description: 'Move to the Instances workspace.',
+            },
+            shortcutFocusActiveSession: {
+                label: 'Active session',
+                scope: 'Shortcut',
+                description: 'Move to the selected instance Preview tab.',
+            },
+            shortcutFocusNotes: {
+                label: 'Notes',
+                scope: 'Shortcut',
+                description: 'Move to the Notes workspace.',
+            },
+            shortcutPreviousInstance: {
+                label: 'Previous instance',
+                scope: 'Shortcut',
+                description: 'Select the previous instance in the current filtered list.',
+            },
+            shortcutNextInstance: {
+                label: 'Next instance',
+                scope: 'Shortcut',
+                description: 'Select the next instance in the current filtered list.',
+            },
         },
         support: {
             ariaLabel: 'Activity title source readiness',
@@ -118,6 +188,8 @@ const COPY = {
         displayDescription: '这些设置只影响左侧实例列表与已保存的管理器界面偏好。',
         activityTitle: '预览与活动',
         activityDescription: '最近活动标题取决于各实例服务器的 endpoint 版本。',
+        embeddingTitle: '嵌入搜索',
+        embeddingDescription: '向量嵌入 Provider 设置与内存索引管理。',
         fields: {
             activity: {
                 label: '最近活动预览',
@@ -144,6 +216,36 @@ const COPY = {
                 scope: '整个 Jaw 界面',
                 description: '为支持 i18n 的管理器仪表盘界面设置已保存的语言。',
             },
+            shortcuts: {
+                label: '全局快捷键',
+                scope: 'Manager dashboard',
+                description: '在输入框和编辑器外启用 Manager 导航快捷键。',
+            },
+            shortcutFocusInstances: {
+                label: '实例列表',
+                scope: '快捷键',
+                description: '切换到 Instances 工作区。',
+            },
+            shortcutFocusActiveSession: {
+                label: '活动会话',
+                scope: '快捷键',
+                description: '切换到已选实例的 Preview 标签。',
+            },
+            shortcutFocusNotes: {
+                label: 'Notes',
+                scope: '快捷键',
+                description: '切换到 Notes 工作区。',
+            },
+            shortcutPreviousInstance: {
+                label: '上一个实例',
+                scope: '快捷键',
+                description: '选择当前筛选列表中的上一个实例。',
+            },
+            shortcutNextInstance: {
+                label: '下一个实例',
+                scope: '快捷键',
+                description: '选择当前筛选列表中的下一个实例。',
+            },
         },
         support: {
             ariaLabel: '活动标题来源就绪状态',
@@ -162,6 +264,8 @@ const COPY = {
         displayDescription: 'これらの設定は左側のインスタンス一覧と保存済みのマネージャー UI 設定にのみ反映されます。',
         activityTitle: 'プレビューとアクティビティ',
         activityDescription: '最近のアクティビティタイトルは各インスタンスサーバーの endpoint バージョンによって変わります。',
+        embeddingTitle: 'エンベディング検索',
+        embeddingDescription: 'ベクトルエンベディング Provider の設定とメモリインデックスの管理。',
         fields: {
             activity: {
                 label: '最近のアクティビティのプレビュー',
@@ -188,6 +292,36 @@ const COPY = {
                 scope: 'Jaw UI 全体',
                 description: 'i18n 対応のマネージャーダッシュボード画面で使用する言語を保存します。',
             },
+            shortcuts: {
+                label: 'グローバルショートカット',
+                scope: 'Manager dashboard',
+                description: '入力欄とエディタ外で Manager ナビゲーションショートカットを有効にします。',
+            },
+            shortcutFocusInstances: {
+                label: 'インスタンス一覧',
+                scope: 'ショートカット',
+                description: 'Instances ワークスペースへ移動します。',
+            },
+            shortcutFocusActiveSession: {
+                label: 'アクティブセッション',
+                scope: 'ショートカット',
+                description: '選択中インスタンスの Preview タブへ移動します。',
+            },
+            shortcutFocusNotes: {
+                label: 'Notes',
+                scope: 'ショートカット',
+                description: 'Notes ワークスペースへ移動します。',
+            },
+            shortcutPreviousInstance: {
+                label: '前のインスタンス',
+                scope: 'ショートカット',
+                description: '現在のフィルタ一覧で前のインスタンスを選択します。',
+            },
+            shortcutNextInstance: {
+                label: '次のインスタンス',
+                scope: 'ショートカット',
+                description: '現在のフィルタ一覧で次のインスタンスを選択します。',
+            },
         },
         support: {
             ariaLabel: 'アクティビティタイトル取得元の準備状態',
@@ -258,6 +392,15 @@ type DashboardSettingSelectProps = {
     onChange: (value: DashboardLocale) => void;
 };
 
+type DashboardShortcutInputProps = {
+    action: DashboardShortcutAction;
+    label: string;
+    scope: string;
+    description: string;
+    value: string;
+    onChange: (action: DashboardShortcutAction, value: string) => void;
+};
+
 function DashboardSettingSelect(props: DashboardSettingSelectProps) {
     return (
         <DashboardSettingRow id={props.id} label={props.label} scope={props.scope} description={props.description}>
@@ -275,6 +418,30 @@ function DashboardSettingSelect(props: DashboardSettingSelectProps) {
     );
 }
 
+function DashboardShortcutInput(props: DashboardShortcutInputProps) {
+    return (
+        <DashboardSettingRow id={`dashboard-shortcut-${props.action}`} label={props.label} scope={props.scope} description={props.description}>
+            <input
+                id={`dashboard-shortcut-${props.action}`}
+                className="dashboard-settings-shortcut-input"
+                type="text"
+                value={props.value}
+                aria-label={`${props.label} shortcut`}
+                placeholder="Alt+I"
+                onChange={(event) => props.onChange(props.action, event.currentTarget.value)}
+            />
+        </DashboardSettingRow>
+    );
+}
+
+function shortcutCopyKey(action: DashboardShortcutAction): keyof typeof COPY.ko.fields {
+    if (action === 'focusInstances') return 'shortcutFocusInstances';
+    if (action === 'focusActiveSession') return 'shortcutFocusActiveSession';
+    if (action === 'focusNotes') return 'shortcutFocusNotes';
+    if (action === 'previousInstance') return 'shortcutPreviousInstance';
+    return 'shortcutNextInstance';
+}
+
 function TitleSupportSummary({ support, locale }: { support: DashboardActivityTitleSupport; locale: DashboardLocale }) {
     const total = support.ready + support.legacy + support.offline;
     const copy = COPY[locale].support;
@@ -305,11 +472,23 @@ export function DashboardSettingsWorkspace(props: DashboardSettingsWorkspaceProp
         document.documentElement.lang = locale;
     }, [locale]);
 
+    function patchShortcut(action: DashboardShortcutAction, value: string): void {
+        props.onUiPatch({
+            dashboardShortcutKeymap: {
+                ...props.ui.dashboardShortcutKeymap,
+                [action]: value,
+            },
+        });
+    }
+
     return (
         <main className="dashboard-settings-workspace" aria-label={copy.ariaLabel}>
             <header className="dashboard-settings-header">
-                <span className="eyebrow">{copy.eyebrow}</span>
-                <h2>{copy.title}</h2>
+                <div>
+                    <span className="eyebrow">{copy.eyebrow}</span>
+                    <h2>{copy.title}</h2>
+                </div>
+                <HelpTopicButton topic="settings" label="Open Settings help" onOpen={props.onOpenHelpTopic} />
             </header>
             {props.activeSection === 'display' ? (
                 <section className="dashboard-settings-section">
@@ -359,9 +538,31 @@ export function DashboardSettingsWorkspace(props: DashboardSettingsWorkspaceProp
                             description={copy.fields.language.description}
                             onChange={(next) => props.onUiPatch({ locale: next })}
                         />
+                        <DashboardSettingToggle
+                            id="dashboard-shortcuts-enabled"
+                            label={copy.fields.shortcuts.label}
+                            scope={copy.fields.shortcuts.scope}
+                            value={props.ui.dashboardShortcutsEnabled}
+                            description={copy.fields.shortcuts.description}
+                            onChange={(next) => props.onUiPatch({ dashboardShortcutsEnabled: next })}
+                        />
+                        {MANAGER_SHORTCUT_ACTIONS.map(action => {
+                            const field = copy.fields[shortcutCopyKey(action)];
+                            return (
+                                <DashboardShortcutInput
+                                    key={action}
+                                    action={action}
+                                    label={field.label}
+                                    scope={field.scope}
+                                    value={props.ui.dashboardShortcutKeymap[action]}
+                                    description={`${field.description} Current: ${formatShortcut(props.ui.dashboardShortcutKeymap[action])}`}
+                                    onChange={patchShortcut}
+                                />
+                            );
+                        })}
                     </div>
                 </section>
-            ) : (
+            ) : props.activeSection === 'activity' ? (
                 <section className="dashboard-settings-section">
                     <header>
                         <h3>{copy.activityTitle}</h3>
@@ -369,6 +570,16 @@ export function DashboardSettingsWorkspace(props: DashboardSettingsWorkspaceProp
                     </header>
                     <TitleSupportSummary support={props.titleSupport} locale={locale} />
                 </section>
+            ) : (
+                <section className="dashboard-settings-section">
+                    <header>
+                        <h3>{copy.embeddingTitle}</h3>
+                        <p>{copy.embeddingDescription}</p>
+                    </header>
+                    <Suspense fallback={<p>Loading...</p>}>
+                        <LazyEmbedding />
+                    </Suspense>
+                </section>
             )}
         </main>
     );

package/public/manager/src/dashboard-settings/dashboard-settings-ui.ts

@@ -27,5 +27,7 @@ export function dashboardSettingsUiFromView(
         showInlineLabelEditor: view.showInlineLabelEditor,
         showSidebarRuntimeLine: view.showSidebarRuntimeLine,
         showSelectedRowActions: view.showSelectedRowActions,
+        dashboardShortcutsEnabled: view.dashboardShortcutsEnabled,
+        dashboardShortcutKeymap: view.dashboardShortcutKeymap,
     };
 }

package/public/manager/src/dashboard-url-state.ts

@@ -0,0 +1,15 @@
+import type { DashboardSidebarMode } from './types';
+
+const SIDEBAR_MODES = new Set<DashboardSidebarMode>([
+    'instances',
+    'board',
+    'schedule',
+    'reminders',
+    'notes',
+    'settings',
+]);
+
+export function readInitialSidebarMode(search: string): DashboardSidebarMode | null {
+    const mode = new URLSearchParams(search).get('sidebar');
+    return SIDEBAR_MODES.has(mode as DashboardSidebarMode) ? mode as DashboardSidebarMode : null;
+}

package/public/manager/src/help/HelpDrawer.tsx

@@ -1,14 +1,13 @@
 import { useEffect, useRef } from 'react';
-import type { DashboardSidebarMode } from '../types';
-import { HELP_CONTENT } from './helpContent';
+import { HELP_CONTENT, type HelpTopicId } from './helpContent';
 
 type HelpDrawerProps = {
     open: boolean;
-    mode: DashboardSidebarMode;
+    topic: HelpTopicId;
     onClose: () => void;
 };
 
-export function HelpDrawer({ open, mode, onClose }: HelpDrawerProps) {
+export function HelpDrawer({ open, topic, onClose }: HelpDrawerProps) {
     const closeRef = useRef<HTMLButtonElement | null>(null);
 
     useEffect(() => {
@@ -22,7 +21,7 @@ export function HelpDrawer({ open, mode, onClose }: HelpDrawerProps) {
     }, [open, onClose]);
 
     if (!open) return null;
-    const entry = HELP_CONTENT[mode];
+    const entry = HELP_CONTENT[topic];
     return (
         <>
             <div className="help-drawer-overlay" onClick={onClose} aria-hidden="true" />
@@ -43,7 +42,7 @@ export function HelpDrawer({ open, mode, onClose }: HelpDrawerProps) {
                 </header>
                 <div className="help-drawer-body">{entry.body}</div>
                 <footer className="help-drawer-footer">
-                    <span>모드를 바꾸시면 도움말도 자동으로 따라가요 🦈</span>
+                    <span>사이드바 도움말은 현재 모드를 따르고, ? 키는 단축키 도움말을 열어요.</span>
                 </footer>
             </aside>
         </>

package/public/manager/src/help/HelpTopicButton.tsx

@@ -0,0 +1,23 @@
+import type { HelpTopicId } from './helpContent';
+
+type HelpTopicButtonProps = {
+    topic: HelpTopicId;
+    label: string;
+    onOpen: (topic: HelpTopicId) => void;
+    className?: string;
+};
+
+export function HelpTopicButton(props: HelpTopicButtonProps) {
+    const className = props.className ? `help-topic-button ${props.className}` : 'help-topic-button';
+    return (
+        <button
+            type="button"
+            className={className}
+            aria-label={props.label}
+            title={props.label}
+            onClick={() => props.onOpen(props.topic)}
+        >
+            ?
+        </button>
+    );
+}

package/public/manager/src/help/help-shortcuts.ts

@@ -0,0 +1,7 @@
+export function isHelpShortcutEditableTarget(target: EventTarget | null): boolean {
+    if (!(target instanceof HTMLElement)) return false;
+    if (target.isContentEditable) return true;
+    const tag = target.tagName.toLowerCase();
+    if (tag === 'input' || tag === 'textarea' || tag === 'select') return true;
+    return Boolean(target.closest('[contenteditable="true"], .cm-editor, .ProseMirror, [data-milkdown-root]'));
+}

package/public/manager/src/help/helpContent.tsx

@@ -1,6 +1,9 @@
 import type { ReactNode } from 'react';
+import { DEFAULT_MANAGER_SHORTCUT_KEYMAP, formatShortcut } from '../manager-shortcuts';
 import type { DashboardSidebarMode } from '../types';
 
+export type HelpTopicId = DashboardSidebarMode | 'shortcuts' | 'routing' | 'processLifecycle' | 'dangerousActions';
+
 export type HelpEntry = {
     title: string;
     subtitle: string;
@@ -15,7 +18,17 @@ const InstancesHelp = (
             <li>우측 상단 상태 점이 초록이면 온라인, 회색이면 오프라인이에요.</li>
             <li>인스턴스에 직접 메시지를 보내실 땐 Preview 탭의 채팅 입력을 쓰세요.</li>
         </ul>
-        <p className="help-tip">💡 인스턴스가 안 보이시면 터미널에서 <code>cli-jaw start</code>로 새 jaw를 띄워보세요 — 자동으로 목록에 떠요.</p>
+        <div className="help-deep">
+            <h4>빠른 판단 기준</h4>
+            <table className="help-table">
+                <tbody>
+                    <tr><th>Preview</th><td>실제 인스턴스 화면을 보거나 메시지를 보낼 때</td></tr>
+                    <tr><th>Logs</th><td>응답이 멈췄거나 dispatch 실패 원인을 확인할 때</td></tr>
+                    <tr><th>Settings</th><td>해당 인스턴스의 CLI, 모델, 권한을 조정할 때</td></tr>
+                </tbody>
+            </table>
+        </div>
+        <p className="help-tip">인스턴스가 안 보이시면 터미널에서 <code>cli-jaw start</code>로 새 jaw를 띄워보세요. 자동으로 목록에 떠요.</p>
     </>
 );
 
@@ -31,7 +44,17 @@ const BoardHelp = (
             <li>인스턴스 블럭을 일반 칸반 블럭 안의 드롭 영역으로 끌어 넣으면 내부 자식 블럭으로 병합돼요. 인스턴스 실행에는 영향 없어요.</li>
             <li>일반 칸반 블럭은 직접 드래그해서 다른 레인으로 옮길 수 있고, <strong>Move</strong> / <strong>Delete</strong>도 유지돼요.</li>
         </ul>
-        <p className="help-tip">💡 인스턴스가 없어도 일반 칸반 블럭은 계속 남아요. 그래서 쿼리·아이디어·작업 단위를 먼저 적고, 필요할 때만 실행 인스턴스를 붙이면 돼요.</p>
+        <div className="help-deep">
+            <h4>상태를 나눠 쓰는 법</h4>
+            <table className="help-table">
+                <tbody>
+                    <tr><th>Ready</th><td>바로 구현하거나 검증할 수 있는 작업</td></tr>
+                    <tr><th>Review</th><td>직원 감사, Pro 검증, 수동 smoke가 필요한 작업</td></tr>
+                    <tr><th>Done</th><td>커밋, 푸시, 이슈 close까지 끝난 작업</td></tr>
+                </tbody>
+            </table>
+        </div>
+        <p className="help-tip">인스턴스가 없어도 일반 칸반 블럭은 계속 남아요. 쿼리·아이디어·작업 단위를 먼저 적고, 필요할 때만 실행 인스턴스를 붙이면 돼요.</p>
     </>
 );
 
@@ -43,7 +66,17 @@ const ScheduleHelp = (
             <li>Run 버튼으로 즉시 dispatch, 대상 인스턴스가 바쁘면 자동 큐잉이에요. last/next 컬럼으로 실행 이력이 보여요.</li>
             <li>예전엔 인스턴스마다 자기 <code>heartbeat.json</code>을 setInterval로 돌리던 구조였는데, 지금은 <strong>매니저가 단일 ticker</strong>로 돌려요. heartbeat.json은 legacy로만 표시되고 자동 실행은 안 돼요.</li>
         </ul>
-        <p className="help-tip">💡 새 작업은 여기서 만들고, 기존 heartbeat job은 같은 cron으로 옮겨 등록하시면 돼요. (마이그레이션 자동화는 추후 추가)</p>
+        <div className="help-deep">
+            <h4>실패를 볼 때</h4>
+            <table className="help-table">
+                <tbody>
+                    <tr><th>queued</th><td>대상 인스턴스가 바빠서 대기 중</td></tr>
+                    <tr><th>blocked</th><td>비활성화했거나 실행 조건이 아직 맞지 않음</td></tr>
+                    <tr><th>last/next</th><td>최근 실행 결과와 다음 실행 예측을 확인하는 기준</td></tr>
+                </tbody>
+            </table>
+        </div>
+        <p className="help-tip">새 작업은 여기서 만들고, 기존 heartbeat job은 같은 cron으로 옮겨 등록하시면 돼요. 마이그레이션 자동화는 추후 추가됩니다.</p>
     </>
 );
 
@@ -59,6 +92,28 @@ const NotesHelp = (
     </>
 );
 
+const RemindersHelp = (
+    <>
+        <p className="help-lead">Jaw Reminders 스냅샷을 대시보드에서 읽고 확인하는 미러 화면이에요.</p>
+        <ul className="help-bullets">
+            <li><strong>All / Focused / Scheduled / High / Done</strong> 보기로 현재 reminder 상태를 훑어볼 수 있어요.</li>
+            <li>Refresh는 외부 Jaw Reminders 스냅샷을 다시 읽어서 대시보드용 row로 반영해요.</li>
+            <li>원본 reminder 저장소가 없거나 형식이 맞지 않아도 대시보드는 기존 미러 데이터를 유지하고 상태 메시지만 보여줘요.</li>
+        </ul>
+        <div className="help-deep">
+            <h4>Matrix 보기</h4>
+            <table className="help-table">
+                <tbody>
+                    <tr><th>Top Priority</th><td>지금 먼저 처리할 3개를 따로 고정</td></tr>
+                    <tr><th>Important</th><td>중요하지만 급하지 않은 장기 작업</td></tr>
+                    <tr><th>Waiting</th><td>다른 사람, 직원, 외부 검증을 기다리는 작업</td></tr>
+                </tbody>
+            </table>
+        </div>
+        <p className="help-tip">Reminders는 실험 기능이라 개발 모드 또는 실험 플래그가 켜진 빌드에서만 보여요.</p>
+    </>
+);
+
 const SettingsHelp = (
     <>
         <p className="help-lead">대시보드 외형과 동작 옵션을 조정하는 곳이에요.</p>
@@ -67,14 +122,109 @@ const SettingsHelp = (
             <li>인스턴스 자체 설정이 아니라 <strong>이 대시보드 UI의 환경설정</strong>이에요.</li>
             <li>변경 사항은 즉시 저장돼요.</li>
         </ul>
-        <p className="help-tip">💡 인스턴스 동작을 바꾸시려면 여기가 아니라 <strong>Instances → 해당 인스턴스 → Settings 탭</strong>으로 가세요.</p>
+        <div className="help-deep">
+            <h4>설정 범위</h4>
+            <table className="help-table">
+                <tbody>
+                    <tr><th>Display</th><td>목록, 언어, 단축키 같은 dashboard UI 선호도</td></tr>
+                    <tr><th>Activity</th><td>최근 작업 제목이 어떤 인스턴스에서 준비됐는지 확인</td></tr>
+                    <tr><th>Instance settings</th><td>개별 인스턴스 동작은 Instances workspace에서 수정</td></tr>
+                </tbody>
+            </table>
+        </div>
+        <p className="help-tip">인스턴스 동작을 바꾸시려면 여기가 아니라 <strong>Instances → 해당 인스턴스 → Settings 탭</strong>으로 가세요.</p>
+    </>
+);
+
+const ShortcutsHelp = (
+    <>
+        <p className="help-lead">반복 작업을 줄이는 Manager 전역 단축키예요.</p>
+        <ul className="help-bullets">
+            <li><kbd>?</kbd>는 이 도움말을 열어요. 입력창, 노트 에디터, WYSIWYG 편집 중에는 글자 입력을 방해하지 않아요.</li>
+            <li><kbd>{formatShortcut(DEFAULT_MANAGER_SHORTCUT_KEYMAP.focusInstances)}</kbd>는 Instances workspace로 이동해요.</li>
+            <li><kbd>{formatShortcut(DEFAULT_MANAGER_SHORTCUT_KEYMAP.focusActiveSession)}</kbd>는 선택된 인스턴스의 Preview 탭으로 이동해요.</li>
+            <li><kbd>{formatShortcut(DEFAULT_MANAGER_SHORTCUT_KEYMAP.focusNotes)}</kbd>는 Notes workspace로 이동해요.</li>
+            <li><kbd>{formatShortcut(DEFAULT_MANAGER_SHORTCUT_KEYMAP.previousInstance)}</kbd> / <kbd>{formatShortcut(DEFAULT_MANAGER_SHORTCUT_KEYMAP.nextInstance)}</kbd>는 현재 필터된 인스턴스 목록에서 이전/다음 행을 선택해요.</li>
+            <li><kbd>⌘/Ctrl + S</kbd>는 Notes와 Settings처럼 저장 가능한 화면에서 현재 편집 내용을 저장해요.</li>
+            <li><kbd>⌘/Ctrl + E</kbd>는 Notes 편집 모드를 순환해요.</li>
+            <li>Manager 단축키는 Dashboard settings에서 켜고 끄거나 keymap을 바꿀 수 있어요.</li>
+            <li>Preview 탭을 보는 동안 새 activity는 읽음으로 처리되고, 다른 탭에 있을 때는 Activity Dock에 쌓여요.</li>
+        </ul>
+        <div className="help-deep">
+            <h4>충돌이 날 때</h4>
+            <table className="help-table">
+                <tbody>
+                    <tr><th>입력 중</th><td>글자 입력을 우선하고 전역 shortcut은 실행하지 않음</td></tr>
+                    <tr><th>브라우저 충돌</th><td>Dashboard settings에서 keymap을 바꾸는 것이 안전함</td></tr>
+                    <tr><th>도움말</th><td><kbd>?</kbd>는 현재 workspace 도움말과 shortcut 도움말의 진입점</td></tr>
+                </tbody>
+            </table>
+        </div>
+        <p className="help-tip">단축키는 브라우저 기본 단축키와 에디터 입력을 우선합니다.</p>
+    </>
+);
+
+const RoutingHelp = (
+    <>
+        <p className="help-lead">jaw는 Boss가 직접 처리할지, Employee에게 보낼지 상황에 따라 나눠요.</p>
+        <ul className="help-bullets">
+            <li><strong>Boss</strong>는 현재 대화의 주 작업자예요. 단일 파일 수정, 상태 확인, GitHub 정리는 보통 Boss가 직접 처리해요.</li>
+            <li><strong>Employee</strong>는 <code>cli-jaw dispatch</code>로 보내는 독립 작업자예요. Backend, Frontend, Docs 같은 역할별 검증에 씁니다.</li>
+            <li><strong>PABCD</strong>에서는 A phase가 plan audit, B phase가 read-only verification 중심이에요. 구현은 Boss가 직접 합니다.</li>
+            <li><strong>$computer-use</strong> 요청은 desktop-control 규칙을 따라 real desktop 또는 browser automation 경로로 라우팅돼요.</li>
+        </ul>
+        <p className="help-tip">직원이 다른 repo로 착각하지 않도록 dispatch task에는 현재 repo 절대경로를 함께 넣는 게 원칙이에요.</p>
+    </>
+);
+
+const ProcessLifecycleHelp = (
+    <>
+        <p className="help-lead">Process 상태는 인스턴스 실행과 Manager가 관리하는 preview/runtime 상태를 구분해서 봐야 해요.</p>
+        <ul className="help-bullets">
+            <li><strong>online</strong>은 인스턴스 health check가 통과한 상태예요.</li>
+            <li><strong>offline / timeout / error</strong>는 프로세스가 없거나, 응답이 늦거나, health check가 실패한 상태예요.</li>
+            <li><strong>managed</strong>는 Manager가 띄우거나 복구 대상으로 추적하는 서버예요.</li>
+            <li>탭 전환 후 Preview가 다시 붙을 수 있지만, 인스턴스의 실제 실행 여부는 health/status 쪽을 기준으로 보세요.</li>
+        </ul>
+        <p className="help-tip">Process UI가 비어 보이면 먼저 Refresh로 registry와 health 상태를 다시 읽어보세요.</p>
+    </>
+);
+
+const DangerousActionsHelp = (
+    <>
+        <p className="help-lead">실행 상태를 바꾸는 버튼은 현재 선택한 인스턴스나 Manager-managed 프로세스에 영향을 줘요.</p>
+        <ul className="help-bullets">
+            <li><strong>Stop</strong>은 대상 인스턴스를 중지해요. service-owned 인스턴스는 persistent service 제거까지 포함될 수 있어요.</li>
+            <li><strong>Restart</strong>는 새 실행으로 바뀌므로 uptime과 elapsed time 판단 기준이 다시 시작돼요.</li>
+            <li><strong>Stop all managed</strong>는 Manager가 추적 중인 서버들을 한 번에 중지해요. 외부에서 직접 띄운 프로세스는 대상으로 삼지 않아요.</li>
+            <li><strong>Adopt/recover</strong>는 남아 있는 managed process 기록을 다시 연결하려는 복구 작업이에요.</li>
+        </ul>
+        <p className="help-tip">위험 작업은 가능한 한 확인창을 거치며, 진행 후 상태가 애매하면 Refresh로 실제 health를 확인하세요.</p>
     </>
 );
 
-export const HELP_CONTENT: Record<DashboardSidebarMode, HelpEntry> = {
+export const DASHBOARD_HELP_TOPIC_IDS: HelpTopicId[] = [
+    'instances',
+    'board',
+    'schedule',
+    'reminders',
+    'notes',
+    'settings',
+    'shortcuts',
+    'routing',
+    'processLifecycle',
+    'dangerousActions',
+];
+
+export const HELP_CONTENT: Record<HelpTopicId, HelpEntry> = {
     instances: { title: 'Instances', subtitle: '인스턴스 운영', body: InstancesHelp },
     board: { title: 'Board', subtitle: 'Cross-instance Kanban', body: BoardHelp },
     schedule: { title: 'Schedule', subtitle: '시간 기반 작업', body: ScheduleHelp },
+    reminders: { title: 'Reminders', subtitle: 'Jaw Reminders mirror', body: RemindersHelp },
     notes: { title: 'Notes', subtitle: '마크다운 노트', body: NotesHelp },
     settings: { title: 'Settings', subtitle: '대시보드 설정', body: SettingsHelp },
+    shortcuts: { title: 'Shortcuts', subtitle: '전역 키보드 도움말', body: ShortcutsHelp },
+    routing: { title: 'Routing', subtitle: 'Boss / Employee 작업 흐름', body: RoutingHelp },
+    processLifecycle: { title: 'Process lifecycle', subtitle: '인스턴스와 managed process 상태', body: ProcessLifecycleHelp },
+    dangerousActions: { title: 'Dangerous actions', subtitle: '중지·재시작·복구 작업 영향', body: DangerousActionsHelp },
 };