cli-jaw 2.0.4 → 2.0.5

package/public/manager/src/AppChrome.tsx

@@ -0,0 +1,144 @@
+import type { Dispatch, ReactNode, SetStateAction } from 'react';
+import { CommandBar } from './components/CommandBar';
+import { CommandPalette } from './components/CommandPalette';
+import { ManagerShell } from './components/ManagerShell';
+import { HelpDrawer } from './help/HelpDrawer';
+import { type HelpTopicId } from './help/helpContent';
+import { SidebarRailRouter } from './SidebarRailRouter';
+import { ElectronMetricsPanel } from './electron-metrics';
+import { IframeBridge } from './sync/IframeBridge';
+import { VisibilityBridge } from './sync/VisibilityBridge';
+import { instanceLabel } from './instance-label';
+import type { BoardView } from './dashboard-board/board-view';
+import { type ScheduleGroup } from './dashboard-schedule/DashboardScheduleSidebar';
+import { REMINDERS_WORKSPACE_ENABLED, SCHEDULE_WORKSPACE_ENABLED } from './dashboard-features';
+import type { NotesModelState } from './notes/useNotesModel';
+import type { NotesSidebarMode } from './notes/NotesSidebar';
+import type { CommandPaletteApi } from './hooks/useCommandPalette';
+import type { ThemeApi } from './hooks/useTheme';
+import type { useDashboardView } from './hooks/useDashboardView';
+import type { DashboardDetailTab, DashboardInstance, DashboardNotesAuthoringMode, DashboardNotesViewMode, DashboardScanResult, ManagerEvent, NoteMetadata } from './types';
+
+type AppChromeProps = {
+    view: ReturnType<typeof useDashboardView>;
+    palette: CommandPaletteApi;
+    theme: ThemeApi;
+    query: string;
+    loading: boolean;
+    showHidden: boolean;
+    instances: DashboardInstance[];
+    selectedInstance: DashboardInstance | null;
+    data: DashboardScanResult | null;
+    summary: Record<string, number>;
+    scheduleGroup: ScheduleGroup;
+    boardView: BoardView;
+    notesModel: NotesModelState;
+    notesSelectedNote: NoteMetadata | null;
+    notesDirtyPath: string | null;
+    notesSidebarMode: NotesSidebarMode;
+    notesSearchFocusToken: number;
+    settingsSection: Parameters<typeof SidebarRailRouter>[0]['settingsSection'];
+    dashboardSettingsUi: Parameters<typeof SidebarRailRouter>[0]['dashboardSettingsUi'];
+    titleSupport: Parameters<typeof SidebarRailRouter>[0]['titleSupport'];
+    activityEvents: ManagerEvent[];
+    busyPorts: Set<number>;
+    titlesByPort: Record<number, string>;
+    lifecycleMessage: string | null;
+    error: string | null;
+    registryMessage: string | null;
+    workbenchHeader: ReactNode;
+    detailContent: (tab: DashboardDetailTab) => ReactNode;
+    instanceListContent: ReactNode;
+    drawerProfileFilters: ReactNode;
+    jawCeoWorkbenchButton?: ReactNode;
+    jawCeoVoiceOverlay?: ReactNode;
+    jawCeoConsoleContent?: ReactNode;
+    previewEnabled: boolean;
+    previewRefreshKey: number;
+    autoUnloadNotice: boolean;
+    helpOpen: boolean;
+    helpTopic: HelpTopicId | null;
+    setQuery: Dispatch<SetStateAction<string>>;
+    setShowHidden: Dispatch<SetStateAction<boolean>>;
+    setPreviewEnabled: Dispatch<SetStateAction<boolean>>;
+    setAutoUnloadNotice: Dispatch<SetStateAction<boolean>>;
+    setHelpOpen: Dispatch<SetStateAction<boolean>>;
+    setHelpTopic: Dispatch<SetStateAction<HelpTopicId | null>>;
+    onOpenHelpTopic: (topic: HelpTopicId) => void;
+    setNotesSidebarMode: Dispatch<SetStateAction<NotesSidebarMode>>;
+    setBoardView: Dispatch<SetStateAction<BoardView>>;
+    setScheduleGroup: Dispatch<SetStateAction<ScheduleGroup>>;
+    setDashboardSettingsSection: Dispatch<SetStateAction<Parameters<typeof SidebarRailRouter>[0]['settingsSection']>>;
+    load: (nextShowHidden?: boolean) => Promise<void>;
+    cycleTheme: () => void;
+    openSelectedInBrowser: () => void;
+    handleSelectInstance: (instance: DashboardInstance) => void;
+    handleSidebarModeChange: Parameters<typeof SidebarRailRouter>[0]['onSidebarModeChange'];
+    handleSidebarToggle: () => void;
+    handleNotesSelectedPathChange: (path: string | null) => void;
+    handleNotesViewModeChange: (mode: DashboardNotesViewMode) => void;
+    handleNotesAuthoringModeChange: (mode: DashboardNotesAuthoringMode) => void;
+    handleNotesWordWrapChange: (value: boolean) => void;
+    handleNotesTreeWidthChange: (value: number) => void;
+    openNotesSidebarSearch: () => void;
+    setNotesDirtyPath: Dispatch<SetStateAction<string | null>>;
+    handleTabChange: (tab: DashboardDetailTab) => void;
+    handleActivityToggle: () => void;
+    handleActivityHeight: (height: number) => void;
+    onDismissLifecycleMessage: () => void;
+    handleDashboardSettingsPatch: Parameters<typeof SidebarRailRouter>[0]['onDashboardSettingsPatch'];
+    activityUnreadOpenAndMarkSeen: () => void;
+};
+
+export function AppChrome(props: AppChromeProps) {
+    return (
+        <>
+            <IframeBridge />
+            <VisibilityBridge />
+            <ManagerShell
+                sidebarCollapsed={props.view.sidebarCollapsed}
+                commandBar={<CommandBar query={props.query} loading={props.loading} onQueryChange={props.setQuery} onRefresh={() => void props.load()} onOpenDrawer={() => props.view.setDrawerOpen(true)} theme={props.theme.theme} onThemeChange={props.theme.setTheme} onOpenPalette={props.palette.toggle} />}
+                workspace={(
+                    <SidebarRailRouter sidebarCollapsed={props.view.sidebarCollapsed} activityDockCollapsed={props.view.activityDockCollapsed}
+                        activityDockHeight={props.view.activityDockHeight} drawerOpen={props.view.drawerOpen} onCloseDrawer={() => props.view.setDrawerOpen(false)}
+                        onlineCount={props.summary['online'] || 0} sidebarMode={props.view.sidebarMode} scheduleWorkspaceEnabled={SCHEDULE_WORKSPACE_ENABLED}
+                        remindersWorkspaceEnabled={REMINDERS_WORKSPACE_ENABLED} onSidebarModeChange={props.handleSidebarModeChange}
+                        onToggleSidebar={props.handleSidebarToggle} helpOpen={props.helpOpen} onToggleHelp={() => { props.setHelpTopic(null); props.setHelpOpen(open => !open); }}
+                        onOpenHelpTopic={props.onOpenHelpTopic}
+                        settingsSection={props.settingsSection} locale={props.view.locale} onSettingsSectionChange={props.setDashboardSettingsSection}
+                        notesModel={props.notesModel} notesSelectedPath={props.view.notesSelectedPath} notesSelectedNote={props.notesSelectedNote}
+                        notesDirtyPath={props.notesDirtyPath} notesTreeWidth={props.view.notesTreeWidth} notesSidebarMode={props.notesSidebarMode}
+                        notesSearchFocusToken={props.notesSearchFocusToken} notesViewMode={props.view.notesViewMode} notesAuthoringMode={props.view.notesAuthoringMode}
+                        notesWordWrap={props.view.notesWordWrap} onNotesSidebarModeChange={props.setNotesSidebarMode} onOpenNotesSearch={props.openNotesSidebarSearch}
+                        onNotesSelectedPathChange={props.handleNotesSelectedPathChange} onNotesDirtyPathChange={props.setNotesDirtyPath}
+                        onNotesViewModeChange={props.handleNotesViewModeChange} onNotesAuthoringModeChange={props.handleNotesAuthoringModeChange}
+                        onNotesWordWrapChange={props.handleNotesWordWrapChange} onNotesTreeWidthChange={props.handleNotesTreeWidthChange}
+                        boardView={props.boardView} onBoardViewChange={props.setBoardView} scheduleGroup={props.scheduleGroup} onScheduleGroupChange={props.setScheduleGroup}
+                        instances={props.instances} selectedInstance={props.selectedInstance} data={props.data} titlesByPort={props.titlesByPort}
+                        busyPorts={props.busyPorts} activeDetailTab={props.view.activeDetailTab} onDetailTabChange={props.handleTabChange}
+                        workbenchHeader={props.workbenchHeader} detailContent={props.detailContent} previewEnabled={props.previewEnabled}
+                        previewRefreshKey={props.previewRefreshKey} previewTheme={props.theme.resolved} lifecycleMessage={props.lifecycleMessage}
+                        onDismissLifecycleMessage={props.onDismissLifecycleMessage} instanceListContent={props.instanceListContent} loading={props.loading}
+                        jawCeoWorkbenchButton={props.jawCeoWorkbenchButton} jawCeoVoiceOverlay={props.jawCeoVoiceOverlay} jawCeoConsoleContent={props.jawCeoConsoleContent}
+                        error={props.error} registryMessage={props.registryMessage} managerEvents={props.activityEvents}
+                        onToggleActivity={props.handleActivityToggle} onActivityHeightChange={props.handleActivityHeight} onOpenDrawer={() => props.view.setDrawerOpen(true)}
+                        onSelectTab={props.handleTabChange} onToggleActivityFromMobile={props.activityUnreadOpenAndMarkSeen} drawerProfileFilters={props.drawerProfileFilters}
+                        dashboardSettingsUi={props.dashboardSettingsUi} titleSupport={props.titleSupport} onDashboardSettingsPatch={props.handleDashboardSettingsPatch} />
+                )}
+                activityHeight={props.view.activityDockCollapsed ? 48 : props.view.activityDockHeight}
+            />
+            <CommandPalette open={props.palette.open} onClose={props.palette.close} instances={props.instances} getLabel={instanceLabel}
+                onSelectInstance={props.handleSelectInstance} theme={props.theme.theme} onCycleTheme={props.cycleTheme} onRefresh={() => void props.load()}
+                onToggleHidden={() => { const next = !props.showHidden; props.setShowHidden(next); void props.load(next); }}
+                showHidden={props.showHidden} onOpenSelected={props.openSelectedInBrowser} selectedInstance={props.selectedInstance} />
+            <ElectronMetricsPanel onUnloadPreview={() => props.setPreviewEnabled(false)} />
+            <HelpDrawer open={props.helpOpen} topic={props.helpTopic ?? props.view.sidebarMode} onClose={() => props.setHelpOpen(false)} />
+            {props.autoUnloadNotice && (
+                <div className="preview-auto-unload-notice" role="status">
+                    Preview was unloaded after 5 minutes of inactivity. Toggle the preview switch to re-enable.
+                    <button type="button" className="preview-auto-unload-dismiss" aria-label="Dismiss preview auto-unload notice" onClick={() => props.setAutoUnloadNotice(false)}>x</button>
+                </div>
+            )}
+        </>
+    );
+}

package/public/manager/src/InstancePreview.tsx

@@ -7,6 +7,7 @@ type InstancePreviewProps = {
     instance: DashboardInstance | null;
     data: DashboardScanResult | null;
     enabled: boolean;
+    active: boolean;
     refreshKey: number;
     theme: PreviewTheme;
 };
@@ -59,6 +60,23 @@ export function InstancePreview(props: InstancePreviewProps) {
         syncTheme();
     }, [syncTheme]);
 
+    const prevActiveRef = useRef(false);
+    useEffect(() => {
+        const wasActive = prevActiveRef.current;
+        prevActiveRef.current = props.active;
+        if (!wasActive && props.active && iframeRef.current?.contentWindow && state.src) {
+            const origin = previewTargetOrigin(state.src, iframeRef.current);
+            if (origin && origin !== 'null') {
+                try {
+                    iframeRef.current.contentWindow.postMessage(
+                        { type: 'jaw-preview-visibility', visible: true },
+                        origin,
+                    );
+                } catch { /* cross-origin guard */ }
+            }
+        }
+    }, [props.active, state.src]);
+
     return (
         <aside className="preview-panel" aria-label="Instance preview">
             {(!props.enabled || !state.canPreview) && <div className="preview-empty">{disabledReason}</div>}

package/public/manager/src/SidebarRailRouter.tsx

@@ -0,0 +1,229 @@
+import { useState, type ReactNode } from 'react';
+import { ActivityDock } from './components/ActivityDock';
+import { InstanceDrawer } from './components/InstanceDrawer';
+import { InstanceNavigator } from './components/InstanceNavigator';
+import { MobileNav } from './components/MobileNav';
+import { SidebarRail } from './components/SidebarRail';
+import { Workbench } from './components/Workbench';
+import { WorkspaceLayout } from './components/WorkspaceLayout';
+import { InstancePreview } from './InstancePreview';
+import { DashboardSettingsSidebar, type DashboardSettingsSection } from './dashboard-settings/DashboardSettingsSidebar';
+import { DashboardSettingsWorkspace } from './dashboard-settings/DashboardSettingsWorkspace';
+import { NotesSidebar, type NotesSidebarMode } from './notes/NotesSidebar';
+import { NotesWorkspace } from './notes/NotesWorkspace';
+import { DashboardBoardSidebar } from './dashboard-board/DashboardBoardSidebar';
+import { DashboardBoardWorkspace } from './dashboard-board/DashboardBoardWorkspace';
+import type { BoardView } from './dashboard-board/board-view';
+import { DashboardScheduleSidebar, type ScheduleGroup } from './dashboard-schedule/DashboardScheduleSidebar';
+import { DashboardScheduleWorkspace } from './dashboard-schedule/DashboardScheduleWorkspace';
+import { DashboardRemindersSidebar, type RemindersView } from './dashboard-reminders/DashboardRemindersSidebar';
+import { DashboardRemindersWorkspace } from './dashboard-reminders/DashboardRemindersWorkspace';
+import { useRemindersFeed } from './dashboard-reminders/useRemindersFeed';
+import type { HelpTopicId } from './help/helpContent';
+import type { NotesModelState } from './notes/useNotesModel';
+import type {
+    DashboardDetailTab,
+    DashboardInstance,
+    DashboardNotesAuthoringMode,
+    DashboardNotesViewMode,
+    DashboardScanResult,
+    DashboardSidebarMode,
+    NoteMetadata,
+    DashboardLocale,
+    ManagerEvent,
+} from './types';
+
+type WorkspaceSurfaceProps = {
+    active: boolean;
+    children: ReactNode;
+};
+
+function WorkspaceSurface(props: WorkspaceSurfaceProps) {
+    return <section className={`workspace-surface${props.active ? ' is-active' : ''}`} hidden={!props.active} aria-hidden={!props.active}>{props.children}</section>;
+}
+
+type Props = {
+    sidebarCollapsed: boolean;
+    activityDockCollapsed: boolean;
+    activityDockHeight: number;
+    drawerOpen: boolean;
+    onCloseDrawer: () => void;
+    onlineCount: number;
+    sidebarMode: DashboardSidebarMode;
+    scheduleWorkspaceEnabled: boolean;
+    remindersWorkspaceEnabled: boolean;
+    onSidebarModeChange: (mode: DashboardSidebarMode) => void;
+    onToggleSidebar: () => void;
+    helpOpen: boolean;
+    onToggleHelp: () => void;
+    onOpenHelpTopic: (topic: HelpTopicId) => void;
+    settingsSection: DashboardSettingsSection;
+    locale: DashboardLocale;
+    onSettingsSectionChange: (section: DashboardSettingsSection) => void;
+    notesModel: NotesModelState;
+    notesSelectedPath: string | null;
+    notesSelectedNote: NoteMetadata | null;
+    notesDirtyPath: string | null;
+    notesTreeWidth: number;
+    notesSidebarMode: NotesSidebarMode;
+    notesSearchFocusToken: number;
+    notesViewMode: DashboardNotesViewMode;
+    notesAuthoringMode: DashboardNotesAuthoringMode;
+    notesWordWrap: boolean;
+    onNotesSidebarModeChange: (mode: NotesSidebarMode) => void;
+    onOpenNotesSearch: () => void;
+    onNotesSelectedPathChange: (path: string | null) => void;
+    onNotesDirtyPathChange: (path: string | null) => void;
+    onNotesViewModeChange: (mode: DashboardNotesViewMode) => void;
+    onNotesAuthoringModeChange: (mode: DashboardNotesAuthoringMode) => void;
+    onNotesWordWrapChange: (value: boolean) => void;
+    onNotesTreeWidthChange: (value: number) => void;
+    boardView: BoardView;
+    onBoardViewChange: (view: BoardView) => void;
+    scheduleGroup: ScheduleGroup;
+    onScheduleGroupChange: (group: ScheduleGroup) => void;
+    instances: DashboardInstance[];
+    selectedInstance: DashboardInstance | null;
+    data: DashboardScanResult | null;
+    titlesByPort: Record<number, string>;
+    busyPorts: Set<number>;
+    activeDetailTab: DashboardDetailTab;
+    onDetailTabChange: (tab: DashboardDetailTab) => void;
+    workbenchHeader: ReactNode;
+    detailContent: (tab: DashboardDetailTab) => ReactNode;
+    previewEnabled: boolean;
+    previewRefreshKey: number;
+    previewTheme: 'dark' | 'light';
+    lifecycleMessage: string | null;
+    onDismissLifecycleMessage: () => void;
+    instanceListContent: ReactNode;
+    jawCeoWorkbenchButton?: ReactNode;
+    jawCeoVoiceOverlay?: ReactNode;
+    jawCeoConsoleContent?: ReactNode;
+    loading: boolean;
+    error: string | null;
+    registryMessage: string | null;
+    managerEvents: ManagerEvent[];
+    onToggleActivity: () => void;
+    onActivityHeightChange: (height: number) => void;
+    onOpenDrawer: () => void;
+    onSelectTab: (tab: DashboardDetailTab) => void;
+    onToggleActivityFromMobile: () => void;
+    drawerProfileFilters: ReactNode;
+    dashboardSettingsUi: Parameters<typeof DashboardSettingsWorkspace>[0]['ui'];
+    titleSupport: Parameters<typeof DashboardSettingsWorkspace>[0]['titleSupport'];
+    onDashboardSettingsPatch: Parameters<typeof DashboardSettingsWorkspace>[0]['onUiPatch'];
+};
+
+export function SidebarRailRouter(props: Props) {
+    const [remindersView, setRemindersView] = useState<RemindersView>('matrix');
+    const remindersFeed = useRemindersFeed({ active: props.sidebarMode === 'reminders' });
+    const notesSelectedHiddenByFilter = Boolean(
+        props.notesModel.tagFilter
+        && props.notesSelectedPath
+        && props.notesSelectedNote
+        && !props.notesSelectedNote.tags?.includes(props.notesModel.tagFilter),
+    );
+
+    return (
+        <>
+        {props.jawCeoVoiceOverlay}
+        <WorkspaceLayout
+            sidebarCollapsed={props.sidebarCollapsed}
+            inspectorCollapsed={props.activityDockCollapsed}
+            inspectorHeight={props.activityDockCollapsed ? 48 : props.activityDockHeight}
+            drawerOpen={props.drawerOpen}
+            onCloseDrawer={props.onCloseDrawer}
+            navigator={(
+                <>
+                    <SidebarRail
+                        onlineCount={props.onlineCount}
+                        collapsed={props.sidebarCollapsed}
+                        mode={props.sidebarMode}
+                        scheduleWorkspaceEnabled={props.scheduleWorkspaceEnabled}
+                        remindersWorkspaceEnabled={props.remindersWorkspaceEnabled}
+                        onModeChange={props.onSidebarModeChange}
+                        onToggleSidebar={props.onToggleSidebar}
+                        helpOpen={props.helpOpen}
+                        onToggleHelp={props.onToggleHelp}
+                    />
+                    <div id="manager-sidebar-list" className="manager-sidebar-list">
+                        {props.sidebarMode === 'settings' ? (
+                            <DashboardSettingsSidebar activeSection={props.settingsSection} locale={props.locale} onSectionChange={props.onSettingsSectionChange} />
+                        ) : props.sidebarMode === 'notes' ? (
+                            <NotesSidebar tree={props.notesModel.filteredTree} loading={props.notesModel.loading} error={props.notesModel.error} notesRoot={props.notesModel.notesRoot} selectedPath={props.notesSelectedPath} dirtyPath={props.notesDirtyPath} treeWidth={props.notesTreeWidth} mode={props.notesSidebarMode} searchFocusToken={props.notesSearchFocusToken} tagFilter={props.notesModel.tagFilter} selectedHiddenByFilter={notesSelectedHiddenByFilter} onModeChange={props.onNotesSidebarModeChange} onOpenSearch={props.onOpenNotesSearch} onSelectedPathChange={props.onNotesSelectedPathChange} onRefreshTree={props.notesModel.refresh} onClearTagFilter={() => props.notesModel.setTagFilter(null)} />
+                        ) : props.sidebarMode === 'board' ? (
+                            <DashboardBoardSidebar view={props.boardView} onViewChange={props.onBoardViewChange} instances={props.instances} titlesByPort={props.titlesByPort} busyPorts={props.busyPorts} />
+                        ) : props.scheduleWorkspaceEnabled && props.sidebarMode === 'schedule' ? (
+                            <DashboardScheduleSidebar activeGroup={props.scheduleGroup} onGroupChange={props.onScheduleGroupChange} />
+                        ) : props.remindersWorkspaceEnabled && props.sidebarMode === 'reminders' ? (
+                            <DashboardRemindersSidebar view={remindersView} onViewChange={setRemindersView} items={remindersFeed.items} loading={remindersFeed.loading} onRefresh={() => void remindersFeed.refresh()} onUpdate={(id, patch) => void remindersFeed.update(id, patch)} />
+                        ) : (
+                            <InstanceNavigator active={props.selectedInstance} hiddenCount={props.instances.filter(instance => instance.hidden).length} collapsed={props.sidebarCollapsed}>
+                                {props.instanceListContent}
+                            </InstanceNavigator>
+                        )}
+                    </div>
+                </>
+            )}
+            workbench={(
+                <div className="workspace-surface-stack">
+                    {props.lifecycleMessage && (
+                        <section className="state lifecycle-state" role="status">
+                            <span>{props.lifecycleMessage}</span>
+                            <button type="button" className="state-dismiss" aria-label="Dismiss lifecycle message" onClick={props.onDismissLifecycleMessage}>X</button>
+                        </section>
+                    )}
+                    <div className="workspace-surface-layer">
+                        <WorkspaceSurface active={props.sidebarMode === 'instances'}>
+                            <Workbench mode={props.activeDetailTab} onModeChange={props.onDetailTabChange} header={props.workbenchHeader} modeActions={props.jawCeoWorkbenchButton} overview={props.detailContent('overview')} preview={(
+                                <InstancePreview instance={props.selectedInstance} data={props.data} enabled={props.previewEnabled} active={props.sidebarMode === 'instances' && props.activeDetailTab === 'preview'} refreshKey={props.previewRefreshKey} theme={props.previewTheme} />
+                            )} logs={props.detailContent('logs')} settings={props.detailContent('settings')} />
+                        </WorkspaceSurface>
+                        <WorkspaceSurface active={props.sidebarMode === 'notes'}>
+                            <NotesWorkspace active={props.sidebarMode === 'notes'} selectedPath={props.notesSelectedPath} selectedNote={props.notesSelectedNote} vaultIndex={props.notesModel.index} viewMode={props.notesViewMode} authoringMode={props.notesAuthoringMode} wordWrap={props.notesWordWrap} treeWidth={props.notesTreeWidth} tagFilter={props.notesModel.tagFilter} onOpenSidebarSearch={props.onOpenNotesSearch} onSelectedPathChange={props.onNotesSelectedPathChange} onDirtyPathChange={props.onNotesDirtyPathChange} onViewModeChange={props.onNotesViewModeChange} onAuthoringModeChange={props.onNotesAuthoringModeChange} onWordWrapChange={props.onNotesWordWrapChange} onTreeWidthChange={props.onNotesTreeWidthChange} onTagSelect={props.notesModel.setTagFilter} onWikiLinkNavigate={props.onNotesSelectedPathChange} />
+                        </WorkspaceSurface>
+                        <WorkspaceSurface active={props.sidebarMode === 'settings'}>
+                            <DashboardSettingsWorkspace activeSection={props.settingsSection} ui={props.dashboardSettingsUi} titleSupport={props.titleSupport} onUiPatch={props.onDashboardSettingsPatch} onOpenHelpTopic={props.onOpenHelpTopic} />
+                        </WorkspaceSurface>
+                        <WorkspaceSurface active={props.sidebarMode === 'board'}>
+                            <DashboardBoardWorkspace active={props.sidebarMode === 'board'} view={props.boardView} onViewChange={props.onBoardViewChange} instances={props.instances} selectedPort={props.selectedInstance?.port ?? null} titlesByPort={props.titlesByPort} busyPorts={props.busyPorts} onOpenHelpTopic={props.onOpenHelpTopic} />
+                        </WorkspaceSurface>
+                        {props.scheduleWorkspaceEnabled ? (
+                            <WorkspaceSurface active={props.sidebarMode === 'schedule'}>
+                                <DashboardScheduleWorkspace active={props.sidebarMode === 'schedule'} activeGroup={props.scheduleGroup} busyPorts={props.busyPorts} onOpenHelpTopic={props.onOpenHelpTopic} />
+                            </WorkspaceSurface>
+                        ) : null}
+                        {props.remindersWorkspaceEnabled ? (
+                            <WorkspaceSurface active={props.sidebarMode === 'reminders'}>
+                                <DashboardRemindersWorkspace active={props.sidebarMode === 'reminders'} view={remindersView} feed={remindersFeed} onRefresh={() => void remindersFeed.refresh()} onCreate={(input) => void remindersFeed.create(input)} onUpdate={(id, patch) => void remindersFeed.update(id, patch)} onOpenHelpTopic={props.onOpenHelpTopic} />
+                            </WorkspaceSurface>
+                        ) : null}
+                    </div>
+                </div>
+            )}
+            inspector={(
+                <ActivityDock
+                    collapsed={props.activityDockCollapsed}
+                    height={props.activityDockHeight}
+                    loading={props.loading}
+                    error={props.error}
+                    lifecycleMessage={props.lifecycleMessage}
+                    selectedInstance={props.selectedInstance}
+                    registryMessage={props.registryMessage}
+                    events={props.managerEvents}
+                    onToggle={props.onToggleActivity}
+                    onHeightChange={props.onActivityHeightChange}
+                />
+            )}
+            sidePanel={props.jawCeoConsoleContent}
+            mobileNav={<MobileNav activeTab={props.activeDetailTab} onOpenInstances={props.onOpenDrawer} onSelectTab={props.onSelectTab} onToggleActivity={props.onToggleActivityFromMobile} />}
+            drawer={(
+                <InstanceDrawer open={props.drawerOpen} profileFilters={props.drawerProfileFilters} onClose={props.onCloseDrawer}>
+                    {props.instanceListContent}
+                </InstanceDrawer>
+            )}
+        />
+        </>
+    );
+}

package/public/manager/src/components/ActivityTimeline.tsx

@@ -25,7 +25,7 @@ type ActivityTimelineProps = {
     emptyMessage?: string;
 };
 
-function eventToEntry(event: ManagerEvent): ActivityEntry {
+export function eventToEntry(event: ManagerEvent): ActivityEntry {
     switch (event.kind) {
         case 'scan-completed':
             return { at: event.at, source: 'scan', message: `range ${event.from}-${event.to}, ${event.reachable} reachable` };
@@ -35,6 +35,14 @@ function eventToEntry(event: ManagerEvent): ActivityEntry {
             return { at: event.at, source: event.action, message: `:${event.port} ${event.status}` };
         case 'health-changed':
             return { at: event.at, source: 'health', message: `:${event.port} ${event.from} → ${event.to}` };
+        case 'instance-message': {
+            const title = event.title?.trim();
+            return {
+                at: event.at,
+                source: `:${event.port}`,
+                message: `${event.role}: ${title || `message #${event.messageId}`}`,
+            };
+        }
         case 'version-mismatch':
             return { at: event.at, source: 'version', message: `:${event.port} ${event.expected || '?'} → ${event.seen}` };
         case 'port-collision':

package/public/manager/src/components/ProcessControlPanel.tsx

@@ -68,6 +68,9 @@ export function ProcessControlPanel() {
                     Force release port
                 </button>
             </div>
+            <p className="process-control-hint">
+                Stop all affects only dashboard-managed servers. Adopt/recover reconnects known managed process records without stopping external instances.
+            </p>
             <div className="process-control-list">
                 {state?.managed.map(entry => (
                     <div key={entry.port} className="process-control-row">

package/public/manager/src/components/SidebarRail.tsx

@@ -5,6 +5,7 @@ type SidebarRailProps = {
     collapsed: boolean;
     mode: DashboardSidebarMode;
     scheduleWorkspaceEnabled: boolean;
+    remindersWorkspaceEnabled?: boolean;
     onModeChange: (mode: DashboardSidebarMode) => void;
     onToggleSidebar: () => void;
     helpOpen: boolean;
@@ -68,6 +69,15 @@ function ScheduleIcon() {
     );
 }
 
+function ReminderIcon() {
+    return (
+        <svg viewBox="0 0 20 20" width="16" height="16" fill="none" stroke="currentColor" strokeWidth="1.6" strokeLinecap="round" strokeLinejoin="round" aria-hidden="true" focusable="false">
+            <path d="M5 4h10v13H5z" />
+            <path d="M8 2v4M12 2v4M8 10h4M8 13h3" />
+        </svg>
+    );
+}
+
 function SettingsIcon() {
     return (
         <svg viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" strokeWidth="1.8" strokeLinecap="round" strokeLinejoin="round" aria-hidden="true" focusable="false">
@@ -136,6 +146,18 @@ export function SidebarRail(props: SidebarRailProps) {
                     <ScheduleIcon />
                 </button>
             ) : null}
+            {props.remindersWorkspaceEnabled ? (
+                <button
+                    className={`rail-button rail-workspace-button${props.mode === 'reminders' ? ' is-active' : ''}`}
+                    type="button"
+                    onClick={() => props.onModeChange('reminders')}
+                    aria-label="Reminders"
+                    aria-pressed={props.mode === 'reminders'}
+                    title="Reminders"
+                >
+                    <ReminderIcon />
+                </button>
+            ) : null}
             <button
                 className={`rail-button rail-workspace-button${props.mode === 'notes' ? ' is-active' : ''}`}
                 type="button"

package/public/manager/src/components/Workbench.tsx

@@ -5,6 +5,7 @@ type WorkbenchProps = {
     mode: DashboardDetailTab;
     onModeChange: (mode: DashboardDetailTab) => void;
     header: ReactNode;
+    modeActions?: ReactNode;
     overview: ReactNode;
     preview: ReactNode;
     logs: ReactNode;
@@ -22,19 +23,22 @@ export function Workbench(props: WorkbenchProps) {
         <section className={`workbench workbench-${props.mode}`} aria-label="Selected instance workbench">
             <div className="workbench-header">
                 {props.header}
-                <div className="workbench-mode-tabs" role="tablist" aria-label="Workbench modes">
-                    {MODES.map(mode => (
-                        <button
-                            key={mode}
-                            type="button"
-                            role="tab"
-                            aria-selected={props.mode === mode}
-                            className={props.mode === mode ? 'is-active' : ''}
-                            onClick={() => props.onModeChange(mode)}
-                        >
-                            {modeLabel(mode)}
-                        </button>
-                    ))}
+                <div className="workbench-mode-bar">
+                    <div className="workbench-mode-tabs" role="tablist" aria-label="Workbench modes">
+                        {MODES.map(mode => (
+                            <button
+                                key={mode}
+                                type="button"
+                                role="tab"
+                                aria-selected={props.mode === mode}
+                                className={props.mode === mode ? 'is-active' : ''}
+                                onClick={() => props.onModeChange(mode)}
+                            >
+                                {modeLabel(mode)}
+                            </button>
+                        ))}
+                    </div>
+                    {props.modeActions}
                 </div>
             </div>
             <div className="workbench-body">

package/public/manager/src/components/WorkbenchHeader.tsx

@@ -1,4 +1,6 @@
 import { instanceLabel } from '../instance-label';
+import { HelpTopicButton } from '../help/HelpTopicButton';
+import type { HelpTopicId } from '../help/helpContent';
 import type { DashboardInstance } from '../types';
 
 type WorkbenchHeaderProps = {
@@ -6,12 +8,14 @@ type WorkbenchHeaderProps = {
     previewEnabled: boolean;
     onPreviewEnabledChange: (enabled: boolean) => void;
     onPreviewRefresh: () => void;
+    onOpenHelpTopic?: (topic: HelpTopicId) => void;
 };
 
 export function WorkbenchHeader(props: WorkbenchHeaderProps) {
     const instance = props.instance;
     const canPreview = Boolean(instance?.ok);
     const previewLabel = props.previewEnabled ? 'Preview on' : 'Preview off';
+    const hasActions = Boolean(instance || props.onOpenHelpTopic);
 
     return (
         <div className="detail-header">
@@ -20,40 +24,47 @@ export function WorkbenchHeader(props: WorkbenchHeaderProps) {
                 <h2>{instance ? instanceLabel(instance) : 'No instance selected'}</h2>
                 <span>{instance?.workingDir || instance?.url || 'Select an online instance to inspect it.'}</span>
             </div>
-            {instance && (
+            {hasActions && (
                 <div className="detail-header-actions">
-                    <span
-                        className={`preview-inline-status ${instance.ok && props.previewEnabled ? 'is-ready' : 'is-unavailable'}`}
-                        aria-label={instance.ok && props.previewEnabled ? 'Preview ready' : 'Preview unavailable'}
-                        title={instance.ok && props.previewEnabled ? 'Preview ready' : 'Preview unavailable'}
-                    />
-                    <button
-                        type="button"
-                        className={`preview-switch ${props.previewEnabled ? 'is-on' : 'is-off'}`}
-                        role="switch"
-                        aria-checked={props.previewEnabled}
-                        disabled={!canPreview}
-                        onClick={() => props.onPreviewEnabledChange(!props.previewEnabled)}
-                    >
-                        <span className="preview-switch-track" aria-hidden="true" />
-                        <span>{previewLabel}</span>
-                    </button>
-                    <button
-                        type="button"
-                        className="preview-refresh-button"
-                        disabled={!canPreview || !props.previewEnabled}
-                        onClick={props.onPreviewRefresh}
-                    >
-                        Refresh
-                    </button>
-                    <a className="open-link" href={instance.url} target="_blank" rel="noreferrer">
-                        <svg viewBox="0 0 24 24" width="12" height="12" stroke="currentColor" strokeWidth="2" fill="none" strokeLinecap="round" strokeLinejoin="round" aria-hidden="true">
-                            <path d="M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6" />
-                            <polyline points="15 3 21 3 21 9" />
-                            <line x1="10" y1="14" x2="21" y2="3" />
-                        </svg>
-                        Open
-                    </a>
+                    {props.onOpenHelpTopic ? (
+                        <HelpTopicButton topic="instances" label="Open Instances help" onOpen={props.onOpenHelpTopic} />
+                    ) : null}
+                    {instance ? (
+                        <>
+                            <span
+                                className={`preview-inline-status ${instance.ok && props.previewEnabled ? 'is-ready' : 'is-unavailable'}`}
+                                aria-label={instance.ok && props.previewEnabled ? 'Preview ready' : 'Preview unavailable'}
+                                title={instance.ok && props.previewEnabled ? 'Preview ready' : 'Preview unavailable'}
+                            />
+                            <button
+                                type="button"
+                                className={`preview-switch ${props.previewEnabled ? 'is-on' : 'is-off'}`}
+                                role="switch"
+                                aria-checked={props.previewEnabled}
+                                disabled={!canPreview}
+                                onClick={() => props.onPreviewEnabledChange(!props.previewEnabled)}
+                            >
+                                <span className="preview-switch-track" aria-hidden="true" />
+                                <span>{previewLabel}</span>
+                            </button>
+                            <button
+                                type="button"
+                                className="preview-refresh-button"
+                                disabled={!canPreview || !props.previewEnabled}
+                                onClick={props.onPreviewRefresh}
+                            >
+                                Refresh
+                            </button>
+                            <a className="open-link" href={instance.url} target="_blank" rel="noreferrer">
+                                <svg viewBox="0 0 24 24" width="12" height="12" stroke="currentColor" strokeWidth="2" fill="none" strokeLinecap="round" strokeLinejoin="round" aria-hidden="true">
+                                    <path d="M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6" />
+                                    <polyline points="15 3 21 3 21 9" />
+                                    <line x1="10" y1="14" x2="21" y2="3" />
+                                </svg>
+                                Open
+                            </a>
+                        </>
+                    ) : null}
                 </div>
             )}
         </div>