@geminilight/mindos 0.5.43 → 0.5.44

package/app/components/explore/use-cases.ts

@@ -1,30 +1,58 @@
-export type UseCaseCategory = 'getting-started' | 'cross-agent' | 'knowledge-evolution' | 'advanced';
+/** Capability axis — maps to product pillars */
+export type UseCaseCategory = 'knowledge-management' | 'memory-sync' | 'auto-execute' | 'experience-evolution' | 'human-insights' | 'audit-control';
+
+/** Scenario axis — maps to user journey phase */
+export type UseCaseScenario = 'first-day' | 'daily' | 'project' | 'advanced';
 
 export interface UseCase {
   id: string;
   icon: string;
   category: UseCaseCategory;
+  scenario: UseCaseScenario;
 }
 
 /**
  * C1-C9 use case definitions.
  * All display text (title, description, prompt) comes from i18n — this file is structure only.
+ *
+ * Category (capability axis):
+ *   knowledge-management — Inject, organize, and maintain knowledge
+ *   memory-sync         — Record once, all Agents know
+ *   auto-execute        — One sentence, auto-execute
+ *   experience-evolution — Gets smarter with use
+ *   human-insights      — Understand and manage relationships
+ *   audit-control       — You have final say
+ *
+ * Scenario (journey axis):
+ *   first-day — Onboarding / first-time tasks
+ *   daily     — Everyday workflows
+ *   project   — Project-scoped work
+ *   advanced  — Power-user patterns
  */
 export const useCases: UseCase[] = [
-  { id: 'c1', icon: '👤', category: 'getting-started' },
-  { id: 'c2', icon: '📥', category: 'getting-started' },
-  { id: 'c3', icon: '🔄', category: 'cross-agent' },
-  { id: 'c4', icon: '🔁', category: 'knowledge-evolution' },
-  { id: 'c5', icon: '💡', category: 'cross-agent' },
-  { id: 'c6', icon: '🚀', category: 'cross-agent' },
-  { id: 'c7', icon: '🔍', category: 'knowledge-evolution' },
-  { id: 'c8', icon: '🤝', category: 'knowledge-evolution' },
-  { id: 'c9', icon: '🛡️', category: 'advanced' },
+  { id: 'c1', icon: '👤', category: 'memory-sync',           scenario: 'first-day' },
+  { id: 'c2', icon: '📥', category: 'knowledge-management',  scenario: 'daily' },
+  { id: 'c3', icon: '🔄', category: 'memory-sync',           scenario: 'project' },
+  { id: 'c4', icon: '🔁', category: 'experience-evolution',  scenario: 'daily' },
+  { id: 'c5', icon: '💡', category: 'auto-execute',          scenario: 'daily' },
+  { id: 'c6', icon: '🚀', category: 'auto-execute',          scenario: 'project' },
+  { id: 'c7', icon: '🔍', category: 'knowledge-management',  scenario: 'project' },
+  { id: 'c8', icon: '🤝', category: 'human-insights',        scenario: 'daily' },
+  { id: 'c9', icon: '🛡️', category: 'audit-control',        scenario: 'advanced' },
 ];
 
 export const categories: UseCaseCategory[] = [
-  'getting-started',
-  'cross-agent',
-  'knowledge-evolution',
+  'knowledge-management',
+  'memory-sync',
+  'auto-execute',
+  'experience-evolution',
+  'human-insights',
+  'audit-control',
+];
+
+export const scenarios: UseCaseScenario[] = [
+  'first-day',
+  'daily',
+  'project',
   'advanced',
 ];

package/app/components/panels/DiscoverPanel.tsx

@@ -1,8 +1,7 @@
 'use client';
 
-import { useState } from 'react';
 import Link from 'next/link';
-import { ChevronDown, ChevronRight, ExternalLink, Blocks, Zap } from 'lucide-react';
+import { Lightbulb, Blocks, Zap, LayoutTemplate, ChevronRight, User, Download, RefreshCw, Repeat, Rocket, Search, Handshake, ShieldCheck } from 'lucide-react';
 import PanelHeader from './PanelHeader';
 import { useLocale } from '@/lib/LocaleContext';
 import { useCases } from '@/components/explore/use-cases';
@@ -14,56 +13,61 @@ interface DiscoverPanelProps {
   onMaximize?: () => void;
 }
 
-/** Collapsible section with count badge */
-function Section({
+/** Navigation entry — clickable row linking to a page or showing coming soon */
+function NavEntry({
   icon,
   title,
-  count,
-  defaultOpen = true,
-  children,
+  badge,
+  href,
+  onClick,
 }: {
   icon: React.ReactNode;
   title: string;
-  count?: number;
-  defaultOpen?: boolean;
-  children: React.ReactNode;
+  badge?: React.ReactNode;
+  href?: string;
+  onClick?: () => void;
 }) {
-  const [open, setOpen] = useState(defaultOpen);
+  const content = (
+    <>
+      <span className="flex items-center justify-center w-7 h-7 rounded-md bg-muted shrink-0">{icon}</span>
+      <span className="text-sm font-medium text-foreground flex-1">{title}</span>
+      {badge}
+      <ChevronRight size={14} className="text-muted-foreground shrink-0" />
+    </>
+  );
+
+  const className = "flex items-center gap-3 px-4 py-2.5 hover:bg-muted/50 transition-colors cursor-pointer";
+
+  if (href) {
+    return <Link href={href} className={className}>{content}</Link>;
+  }
+  return <button onClick={onClick} className={`${className} w-full`}>{content}</button>;
+}
+
+/** Coming soon badge */
+function ComingSoonBadge({ label }: { label: string }) {
   return (
-    <div>
-      <button
-        onClick={() => setOpen(v => !v)}
-        className="flex items-center gap-2 w-full px-4 py-2 text-xs font-medium text-muted-foreground uppercase tracking-wider hover:text-foreground transition-colors"
-      >
-        {open ? <ChevronDown size={12} /> : <ChevronRight size={12} />}
-        <span className="flex items-center gap-1.5">
-          {icon}
-          {title}
-        </span>
-        {count !== undefined && (
-          <span className="ml-auto text-2xs tabular-nums opacity-60">{count}</span>
-        )}
-      </button>
-      {open && <div className="pb-2">{children}</div>}
-    </div>
+    <span className="text-2xs px-2 py-0.5 rounded-full bg-muted text-muted-foreground shrink-0">
+      {label}
+    </span>
   );
 }
 
-/** Compact use case row for panel display */
+/** Compact use case row */
 function UseCaseRow({
   icon,
   title,
   prompt,
   tryLabel,
 }: {
-  icon: string;
+  icon: React.ReactNode;
   title: string;
   prompt: string;
   tryLabel: string;
 }) {
   return (
-    <div className="group flex items-center gap-2 px-4 py-1.5 hover:bg-muted/50 transition-colors rounded-sm mx-1">
-      <span className="text-sm leading-none shrink-0" suppressHydrationWarning>{icon}</span>
+    <div className="group flex items-center gap-2.5 px-4 py-1.5 hover:bg-muted/50 transition-colors rounded-sm mx-1">
+      <span className="text-muted-foreground shrink-0">{icon}</span>
       <span className="text-xs text-foreground truncate flex-1">{title}</span>
       <button
         onClick={() => openAskModal(prompt, 'user')}
@@ -75,29 +79,18 @@ function UseCaseRow({
   );
 }
 
-/** Coming soon placeholder */
-function ComingSoonSection({
-  icon,
-  title,
-  description,
-  comingSoonLabel,
-}: {
-  icon: React.ReactNode;
-  title: string;
-  description: string;
-  comingSoonLabel: string;
-}) {
-  return (
-    <Section icon={icon} title={title} defaultOpen={false}>
-      <div className="px-4 py-3 mx-1">
-        <p className="text-xs text-muted-foreground leading-relaxed">{description}</p>
-        <span className="inline-block mt-2 text-2xs px-2 py-0.5 rounded-full bg-muted text-muted-foreground">
-          {comingSoonLabel}
-        </span>
-      </div>
-    </Section>
-  );
-}
+/** Map use case id → lucide icon */
+const useCaseIcons: Record<string, React.ReactNode> = {
+  c1: <User size={12} />,          // Inject Identity
+  c2: <Download size={12} />,      // Save Information
+  c3: <RefreshCw size={12} />,     // Cross-Agent Handoff
+  c4: <Repeat size={12} />,        // Experience → SOP
+  c5: <Lightbulb size={12} />,     // Capture Ideas
+  c6: <Rocket size={12} />,        // Project Cold Start
+  c7: <Search size={12} />,        // Research & Archive
+  c8: <Handshake size={12} />,     // Network Management
+  c9: <ShieldCheck size={12} />,   // Audit & Correct
+};
 
 export default function DiscoverPanel({ active, maximized, onMaximize }: DiscoverPanelProps) {
   const { t } = useLocale();
@@ -117,54 +110,51 @@ export default function DiscoverPanel({ active, maximized, onMaximize }: Discove
     <div className={`flex flex-col h-full ${active ? '' : 'hidden'}`}>
       <PanelHeader title={d.title} maximized={maximized} onMaximize={onMaximize} />
       <div className="flex-1 overflow-y-auto min-h-0">
-        {/* Use Cases */}
-        <Section icon={<span className="text-xs" suppressHydrationWarning>🎯</span>} title={d.useCases} count={useCases.length}>
-          <div className="flex flex-col">
-            {useCases.map(uc => {
-              const data = getUseCaseText(uc.id);
-              if (!data) return null;
-              return (
-                <UseCaseRow
-                  key={uc.id}
-                  icon={uc.icon}
-                  title={data.title}
-                  prompt={data.prompt}
-                  tryLabel={d.tryIt}
-                />
-              );
-            })}
-          </div>
-        </Section>
-
-        <div className="mx-4 border-t border-border" />
-
-        {/* Plugin Market — Coming Soon */}
-        <ComingSoonSection
-          icon={<Blocks size={11} />}
-          title={d.pluginMarket}
-          description={d.pluginMarketDesc}
-          comingSoonLabel={d.comingSoon}
-        />
+        {/* Navigation entries */}
+        <div className="py-2">
+          <NavEntry
+            icon={<Lightbulb size={14} className="text-[var(--amber)]" />}
+            title={d.useCases}
+            badge={<span className="text-2xs tabular-nums text-muted-foreground">{useCases.length}</span>}
+            href="/explore"
+          />
+          <NavEntry
+            icon={<Blocks size={14} className="text-muted-foreground" />}
+            title={d.pluginMarket}
+            badge={<ComingSoonBadge label={d.comingSoon} />}
+          />
+          <NavEntry
+            icon={<Zap size={14} className="text-muted-foreground" />}
+            title={d.skillMarket}
+            badge={<ComingSoonBadge label={d.comingSoon} />}
+          />
+          <NavEntry
+            icon={<LayoutTemplate size={14} className="text-muted-foreground" />}
+            title={d.spaceTemplates}
+            badge={<ComingSoonBadge label={d.comingSoon} />}
+          />
+        </div>
 
         <div className="mx-4 border-t border-border" />
 
-        {/* Skill Market — Coming Soon */}
-        <ComingSoonSection
-          icon={<Zap size={11} />}
-          title={d.skillMarket}
-          description={d.skillMarketDesc}
-          comingSoonLabel={d.comingSoon}
-        />
-
-        {/* View all link */}
-        <div className="px-4 py-3 mt-2">
-          <Link
-            href="/explore"
-            className="inline-flex items-center gap-1.5 text-xs text-[var(--amber)] hover:opacity-80 transition-opacity"
-          >
-            {d.viewAll}
-            <ExternalLink size={11} />
-          </Link>
+        {/* Quick try — use case list */}
+        <div className="py-2">
+          <div className="px-4 py-1.5">
+            <span className="text-2xs font-medium text-muted-foreground uppercase tracking-wider">{d.useCases}</span>
+          </div>
+          {useCases.map(uc => {
+            const data = getUseCaseText(uc.id);
+            if (!data) return null;
+            return (
+              <UseCaseRow
+                key={uc.id}
+                icon={useCaseIcons[uc.id] || <Lightbulb size={12} />}
+                title={data.title}
+                prompt={data.prompt}
+                tryLabel={d.tryIt}
+              />
+            );
+          })}
         </div>
       </div>
     </div>

package/app/components/settings/SettingsContent.tsx

@@ -153,8 +153,8 @@ export default function SettingsContent({ visible, initialTab, variant, onClose
     { id: 'ai', label: t.settings.tabs.ai, icon: <Sparkles size={iconSize} /> },
     { id: 'mcp', label: t.settings.tabs.mcp ?? 'MCP & Skills', icon: <Plug size={iconSize} /> },
     { id: 'knowledge', label: t.settings.tabs.knowledge, icon: <Settings size={iconSize} /> },
-    { id: 'sync', label: t.settings.tabs.sync ?? 'Sync', icon: <RefreshCw size={iconSize} /> },
     { id: 'appearance', label: t.settings.tabs.appearance, icon: <Palette size={iconSize} /> },
+    { id: 'sync', label: t.settings.tabs.sync ?? 'Sync', icon: <RefreshCw size={iconSize} /> },
     { id: 'update', label: t.settings.tabs.update ?? 'Update', icon: <Download size={iconSize} />, badge: hasUpdate },
   ];
 

package/app/components/settings/UpdateTab.tsx

@@ -1,7 +1,7 @@
 'use client';
 
 import { useState, useEffect, useCallback, useRef } from 'react';
-import { Download, RefreshCw, CheckCircle2, AlertCircle, Loader2, ExternalLink } from 'lucide-react';
+import { Download, RefreshCw, CheckCircle2, AlertCircle, Loader2, ExternalLink, Circle } from 'lucide-react';
 import { apiFetch } from '@/lib/api';
 import { useLocale } from '@/lib/LocaleContext';
 
@@ -11,18 +11,53 @@ interface UpdateInfo {
   hasUpdate: boolean;
 }
 
+interface StageInfo {
+  id: string;
+  status: 'pending' | 'running' | 'done' | 'failed';
+}
+
+interface UpdateStatus {
+  stage: string;
+  stages: StageInfo[];
+  error: string | null;
+  version: { from: string | null; to: string | null } | null;
+  startedAt: string | null;
+}
+
 type UpdateState = 'idle' | 'checking' | 'updating' | 'updated' | 'error' | 'timeout';
 
 const CHANGELOG_URL = 'https://github.com/GeminiLight/MindOS/releases';
-const POLL_INTERVAL = 5_000;
-const POLL_TIMEOUT = 4 * 60 * 1000; // 4 minutes
+const POLL_INTERVAL = 3_000;
+const POLL_TIMEOUT = 5 * 60 * 1000; // 5 minutes
+
+const STAGE_LABELS: Record<string, { en: string; zh: string }> = {
+  downloading: { en: 'Downloading update', zh: '下载更新' },
+  skills:      { en: 'Updating skills', zh: '更新 Skills' },
+  rebuilding:  { en: 'Rebuilding app', zh: '重新构建应用' },
+  restarting:  { en: 'Restarting server', zh: '重启服务' },
+};
+
+function StageIcon({ status }: { status: string }) {
+  switch (status) {
+    case 'done':
+      return <CheckCircle2 size={14} className="text-success shrink-0" />;
+    case 'running':
+      return <Loader2 size={14} className="animate-spin shrink-0" style={{ color: 'var(--amber)' }} />;
+    case 'failed':
+      return <AlertCircle size={14} className="text-destructive shrink-0" />;
+    default:
+      return <Circle size={14} className="text-muted-foreground/40 shrink-0" />;
+  }
+}
 
 export function UpdateTab() {
-  const { t } = useLocale();
+  const { t, locale } = useLocale();
   const u = t.settings.update;
   const [info, setInfo] = useState<UpdateInfo | null>(null);
   const [state, setState] = useState<UpdateState>('idle');
   const [errorMsg, setErrorMsg] = useState('');
+  const [stages, setStages] = useState<StageInfo[]>([]);
+  const [updateError, setUpdateError] = useState<string | null>(null);
   const pollRef = useRef<ReturnType<typeof setInterval>>(undefined);
   const timeoutRef = useRef<ReturnType<typeof setTimeout>>(undefined);
   const originalVersion = useRef<string>('');
@@ -43,16 +78,23 @@ export function UpdateTab() {
 
   useEffect(() => { checkUpdate(); }, [checkUpdate]);
 
-  useEffect(() => {
-    return () => {
-      clearInterval(pollRef.current);
-      clearTimeout(timeoutRef.current);
-    };
+  const cleanup = useCallback(() => {
+    clearInterval(pollRef.current);
+    clearTimeout(timeoutRef.current);
   }, []);
 
+  useEffect(() => cleanup, [cleanup]);
+
   const handleUpdate = useCallback(async () => {
     setState('updating');
     setErrorMsg('');
+    setUpdateError(null);
+    setStages([
+      { id: 'downloading', status: 'pending' },
+      { id: 'skills',      status: 'pending' },
+      { id: 'rebuilding',  status: 'pending' },
+      { id: 'restarting',  status: 'pending' },
+    ]);
 
     try {
       await apiFetch('/api/update', { method: 'POST' });
@@ -60,26 +102,67 @@ export function UpdateTab() {
       // Expected — server may die during update
     }
 
+    // Poll update-status for stage progress
     pollRef.current = setInterval(async () => {
+      // Try status endpoint first (may fail when server is restarting)
       try {
-        const data = await apiFetch<UpdateInfo>('/api/update-check');
-        if (data.current !== originalVersion.current) {
-          clearInterval(pollRef.current);
-          clearTimeout(timeoutRef.current);
-          setInfo(data);
-          setState('updated');
-          setTimeout(() => window.location.reload(), 2000);
+        const status = await apiFetch<UpdateStatus>('/api/update-status', { timeout: 5000 });
+
+        if (status.stages?.length > 0) {
+          setStages(status.stages);
+        }
+
+        if (status.stage === 'failed') {
+          cleanup();
+          setUpdateError(status.error || 'Update failed');
+          setState('error');
+          return;
+        }
+
+        if (status.stage === 'done') {
+          // Verify version actually changed
+          try {
+            const data = await apiFetch<UpdateInfo>('/api/update-check');
+            if (data.current !== originalVersion.current) {
+              cleanup();
+              setInfo(data);
+              setState('updated');
+              setTimeout(() => window.location.reload(), 2000);
+              return;
+            }
+          } catch { /* new server may not be fully ready */ }
         }
       } catch {
-        // Server still restarting
+        // Server restarting — also try update-check as fallback
+        try {
+          const data = await apiFetch<UpdateInfo>('/api/update-check', { timeout: 5000 });
+          if (data.current !== originalVersion.current) {
+            cleanup();
+            setStages(prev => prev.map(s => ({ ...s, status: 'done' as const })));
+            setInfo(data);
+            setState('updated');
+            setTimeout(() => window.location.reload(), 2000);
+          }
+        } catch {
+          // Both endpoints down — server still restarting
+        }
       }
     }, POLL_INTERVAL);
 
     timeoutRef.current = setTimeout(() => {
-      clearInterval(pollRef.current);
+      cleanup();
       setState('timeout');
     }, POLL_TIMEOUT);
-  }, []);
+  }, [cleanup]);
+
+  const handleRetry = useCallback(() => {
+    setUpdateError(null);
+    handleUpdate();
+  }, [handleUpdate]);
+
+  const lang = locale === 'zh' ? 'zh' : 'en';
+  const doneCount = stages.filter(s => s.status === 'done').length;
+  const progress = stages.length > 0 ? Math.round((doneCount / stages.length) * 100) : 0;
 
   return (
     <div className="space-y-5">
@@ -114,11 +197,27 @@ export function UpdateTab() {
         )}
 
         {state === 'updating' && (
-          <div className="space-y-2">
-            <div className="flex items-center gap-2 text-xs" style={{ color: 'var(--amber)' }}>
-              <Loader2 size={13} className="animate-spin" />
-              {u?.updating ?? 'Updating MindOS... The server will restart shortly.'}
+          <div className="space-y-3">
+            {/* Stage list */}
+            <div className="space-y-1.5">
+              {stages.map((s) => (
+                <div key={s.id} className="flex items-center gap-2 text-xs">
+                  <StageIcon status={s.status} />
+                  <span className={s.status === 'pending' ? 'text-muted-foreground/50' : s.status === 'running' ? 'text-foreground' : 'text-muted-foreground'}>
+                    {STAGE_LABELS[s.id]?.[lang] ?? s.id}
+                  </span>
+                </div>
+              ))}
+            </div>
+
+            {/* Progress bar */}
+            <div className="h-1 rounded-full bg-muted overflow-hidden">
+              <div
+                className="h-full rounded-full transition-all duration-500 ease-out"
+                style={{ width: `${Math.max(progress, 5)}%`, background: 'var(--amber)' }}
+              />
             </div>
+
             <p className="text-2xs text-muted-foreground">
               {u?.updatingHint ?? 'This may take 1–3 minutes. Do not close this page.'}
             </p>
@@ -133,21 +232,39 @@ export function UpdateTab() {
         )}
 
         {state === 'timeout' && (
-          <div className="space-y-1">
+          <div className="space-y-2">
             <div className="flex items-center gap-2 text-xs text-amber-600 dark:text-amber-400">
               <AlertCircle size={13} />
               {u?.timeout ?? 'Update may still be in progress.'}
             </div>
             <p className="text-2xs text-muted-foreground">
-              {u?.timeoutHint ?? 'Check your terminal:'} <code className="font-mono bg-muted px-1 py-0.5 rounded">mindos logs</code>
+              {u?.timeoutHint ?? 'The server may need more time to rebuild. Try refreshing.'}
             </p>
+            <button
+              onClick={() => window.location.reload()}
+              className="flex items-center gap-1.5 px-3 py-1.5 text-xs rounded-lg border border-border text-muted-foreground hover:text-foreground hover:bg-muted transition-colors"
+            >
+              <RefreshCw size={12} />
+              {u?.refreshButton ?? 'Refresh Page'}
+            </button>
           </div>
         )}
 
         {state === 'error' && (
-          <div className="flex items-center gap-2 text-xs text-destructive">
-            <AlertCircle size={13} />
-            {errorMsg}
+          <div className="space-y-2">
+            <div className="flex items-center gap-2 text-xs text-destructive">
+              <AlertCircle size={13} />
+              {updateError || errorMsg}
+            </div>
+            {updateError && (
+              <button
+                onClick={handleRetry}
+                className="flex items-center gap-1.5 px-3 py-1.5 text-xs rounded-lg border border-border text-muted-foreground hover:text-foreground hover:bg-muted transition-colors"
+              >
+                <RefreshCw size={12} />
+                {u?.retryButton ?? 'Retry Update'}
+              </button>
+            )}
           </div>
         )}
       </div>

package/app/hooks/useAskSession.ts

@@ -60,6 +60,18 @@ async function removeSession(id: string): Promise<void> {
   }
 }
 
+async function removeSessions(ids: string[]): Promise<void> {
+  try {
+    await fetch('/api/ask-sessions', {
+      method: 'DELETE',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ ids }),
+    });
+  } catch {
+    // ignore persistence errors
+  }
+}
+
 export function useAskSession(currentFile?: string) {
   const [messages, setMessages] = useState<Message[]>([]);
   const [sessions, setSessions] = useState<ChatSession[]>([]);
@@ -166,6 +178,17 @@ export function useAskSession(currentFile?: string) {
     [activeSessionId, currentFile, sessions],
   );
 
+  const clearAllSessions = useCallback(() => {
+    const allIds = sessions.map(s => s.id);
+    void removeSessions(allIds);
+
+    const fresh = createSession(currentFile);
+    setActiveSessionId(fresh.id);
+    setMessages([]);
+    setSessions([fresh]);
+    void upsertSession(fresh);
+  }, [currentFile, sessions]);
+
   return {
     messages,
     setMessages,
@@ -177,5 +200,6 @@ export function useAskSession(currentFile?: string) {
     resetSession,
     loadSession,
     deleteSession,
+    clearAllSessions,
   };
 }