@geminilight/mindos 0.6.43 → 0.6.45

package/_standalone/__tests__/lib/i18n-new-keys.test.ts

@@ -60,8 +60,8 @@ describe('i18n walkthrough keys', () => {
     expect(w.exploreCta).toBeTruthy();
   });
 
-  it('defines exactly 4 steps', () => {
-    expect(w.steps).toHaveLength(4);
+  it('defines exactly 3 steps', () => {
+    expect(w.steps).toHaveLength(3);
   });
 
   it('each step has title and body', () => {

package/_standalone/__tests__/lib/walkthrough-steps.test.ts

@@ -2,8 +2,8 @@ import { describe, it, expect } from 'vitest';
 import { walkthroughSteps } from '@/components/walkthrough/steps';
 
 describe('walkthrough/steps', () => {
-  it('defines exactly 4 steps', () => {
-    expect(walkthroughSteps).toHaveLength(4);
+  it('defines exactly 3 steps', () => {
+    expect(walkthroughSteps).toHaveLength(3);
   });
 
   it('each step has anchor and position', () => {
@@ -19,7 +19,7 @@ describe('walkthrough/steps', () => {
   });
 
   it('anchors match the value-driven walkthrough sequence', () => {
-    const expected = ['files-panel', 'ask-button', 'agents-panel', 'echo-panel'];
+    const expected = ['files-panel', 'ask-button', 'agents-panel'];
     expect(walkthroughSteps.map(s => s.anchor)).toEqual(expected);
   });
 });

package/_standalone/components/setup/StepAI.tsx

@@ -27,11 +27,12 @@ export default function StepAI({ state, update, s, onCopyToken, webPortStatus, m
   const { locale } = useLocale();
   const [portsOpen, setPortsOpen] = useState(false);
 
+  // Only auto-open Advanced if there's an unresolved port issue the user needs to see
   useEffect(() => {
-    if (!portsOpen && (webPortStatus.available === false || mcpPortStatus.available === false || portConflict)) {
+    if (!portsOpen && portConflict) {
       setPortsOpen(true);
     }
-  }, [webPortStatus.available, mcpPortStatus.available, portConflict, portsOpen]);
+  }, [portConflict, portsOpen]);
 
   const currentProvider = state.provider !== 'skip' && isProviderId(state.provider) ? state.provider : null;
   const currentPreset = currentProvider ? PROVIDER_PRESETS[currentProvider] : null;
@@ -58,6 +59,7 @@ export default function StepAI({ state, update, s, onCopyToken, webPortStatus, m
         value={state.provider}
         onChange={id => update('provider', id)}
         showSkip
+        compact
         configuredProviders={configuredProviders}
       />
 

package/_standalone/components/walkthrough/WalkthroughOverlay.tsx

@@ -68,6 +68,17 @@ export default function WalkthroughOverlay() {
     return () => window.removeEventListener('keydown', handler, true);
   }, [skipFn]);
 
+  // If target element doesn't exist (e.g. Echo not enabled), auto-skip this step
+  useEffect(() => {
+    if (!step) return;
+    const el = document.querySelector(`[data-walkthrough="${step.anchor}"]`);
+    if (!el) {
+      // Target not in DOM — skip to next step after a brief delay
+      const timer = setTimeout(() => wt?.next(), 100);
+      return () => clearTimeout(timer);
+    }
+  }, [step, wt]);
+
   if (!wt || !step) return null;
 
   // Mobile: bottom sheet instead of spotlight
@@ -98,6 +109,8 @@ export default function WalkthroughOverlay() {
             if (!inSpotlight) {
               wt.skip();
             }
+          } else {
+            wt.skip();
           }
         }}
       >

package/_standalone/components/walkthrough/steps.ts

@@ -2,8 +2,7 @@
 export type WalkthroughAnchor =
   | 'files-panel'
   | 'ask-button'
-  | 'agents-panel'
-  | 'echo-panel';
+  | 'agents-panel';
 
 export interface WalkthroughStep {
   anchor: WalkthroughAnchor;
@@ -12,15 +11,13 @@ export interface WalkthroughStep {
 }
 
 /**
- * 4-step value-driven walkthrough aligned with the Dual-Layer Wedge strategy:
+ * 3-step value-driven walkthrough:
  *   0. Project Memory (foundation)
  *   1. AI That Already Knows You (wedge)
  *   2. Multi-Agent Sharing (differentiation)
- *   3. Echo — Cognitive Compound Interest (retention seed)
  */
 export const walkthroughSteps: WalkthroughStep[] = [
   { anchor: 'files-panel', position: 'right' },
   { anchor: 'ask-button', position: 'right' },
   { anchor: 'agents-panel', position: 'right' },
-  { anchor: 'echo-panel', position: 'right' },
 ];

package/_standalone/lib/i18n/modules/onboarding.ts

@@ -211,10 +211,6 @@ export const onboardingEn = {
         title: 'Connect Any Agent',
         body: 'Link Cursor, Claude Code, or Windsurf via MCP — they all share the same project memory.',
       },
-      {
-        title: 'Echo — Growth Compounds',
-        body: 'About you, daily reflections, growth tracking — MindOS helps you accumulate cognitive compound interest over time.',
-      },
     ],
   },
 } as const;
@@ -430,10 +426,6 @@ export const onboardingZh = {
         title: '多 Agent 共享记忆',
         body: '通过 MCP 连接 Cursor、Claude Code、Windsurf，它们共享同一份项目记忆。',
       },
-      {
-        title: '回响 — 认知在积累',
-        body: '关于你、每日回顾、成长轨迹——MindOS 帮你沉淀判断与偏好，让经验不断复利。',
-      },
     ],
   },
 };

package/app/app/global-error.tsx

@@ -0,0 +1,50 @@
+'use client';
+
+/**
+ * Root-level error boundary that catches errors in the entire app,
+ * including layout.tsx and server component failures.
+ * This prevents the generic "Application error" white screen.
+ */
+export default function GlobalError({
+  error,
+  reset,
+}: {
+  error: Error & { digest?: string };
+  reset: () => void;
+}) {
+  return (
+    <html lang="en">
+      <body style={{ margin: 0, fontFamily: 'system-ui, sans-serif', background: '#0f0f0f', color: '#e5e5e5' }}>
+        <div style={{
+          display: 'flex', flexDirection: 'column', alignItems: 'center', justifyContent: 'center',
+          minHeight: '100vh', gap: '16px', padding: '24px', textAlign: 'center',
+        }}>
+          <h2 style={{ fontSize: '18px', fontWeight: 600, margin: 0 }}>Something went wrong</h2>
+          <p style={{ fontSize: '14px', color: '#888', maxWidth: '400px', margin: 0 }}>
+            {error.message || 'An unexpected error occurred. Please try again.'}
+          </p>
+          <div style={{ display: 'flex', gap: '12px', marginTop: '8px' }}>
+            <button
+              onClick={reset}
+              style={{
+                padding: '8px 16px', borderRadius: '6px', fontSize: '14px', fontWeight: 500,
+                background: '#222', color: '#e5e5e5', border: '1px solid #333', cursor: 'pointer',
+              }}
+            >
+              Try again
+            </button>
+            <a
+              href="/setup"
+              style={{
+                padding: '8px 16px', borderRadius: '6px', fontSize: '14px', fontWeight: 500,
+                background: '#c8873a', color: '#fff', textDecoration: 'none', cursor: 'pointer',
+              }}
+            >
+              Go to Setup
+            </a>
+          </div>
+        </div>
+      </body>
+    </html>
+  );
+}

package/app/app/page.tsx

@@ -54,12 +54,16 @@ function getTopLevelDirs(): SpaceInfo[] {
 }
 
 function getExistingFiles(paths: string[]): string[] {
-  const root = getMindRoot();
-  return paths.filter(p => {
-    try {
-      return fs.existsSync(path.join(root, p));
-    } catch { return false; }
-  });
+  try {
+    const root = getMindRoot();
+    return paths.filter(p => {
+      try {
+        return fs.existsSync(path.join(root, p));
+      } catch { return false; }
+    });
+  } catch {
+    return [];
+  }
 }
 
 export default function HomePage() {

package/app/components/setup/StepAI.tsx

@@ -27,11 +27,12 @@ export default function StepAI({ state, update, s, onCopyToken, webPortStatus, m
   const { locale } = useLocale();
   const [portsOpen, setPortsOpen] = useState(false);
 
+  // Only auto-open Advanced if there's an unresolved port issue the user needs to see
   useEffect(() => {
-    if (!portsOpen && (webPortStatus.available === false || mcpPortStatus.available === false || portConflict)) {
+    if (!portsOpen && portConflict) {
       setPortsOpen(true);
     }
-  }, [webPortStatus.available, mcpPortStatus.available, portConflict, portsOpen]);
+  }, [portConflict, portsOpen]);
 
   const currentProvider = state.provider !== 'skip' && isProviderId(state.provider) ? state.provider : null;
   const currentPreset = currentProvider ? PROVIDER_PRESETS[currentProvider] : null;
@@ -58,6 +59,7 @@ export default function StepAI({ state, update, s, onCopyToken, webPortStatus, m
         value={state.provider}
         onChange={id => update('provider', id)}
         showSkip
+        compact
         configuredProviders={configuredProviders}
       />
 

package/app/components/setup/index.tsx

@@ -207,11 +207,11 @@ export default function SetupWizard() {
       });
   }, []);
 
-  // Auto-check ports when entering AI step (ports are in Advanced section)
+  // Auto-check ports when entering AI step — auto-resolve occupied ports
   useEffect(() => {
     if (step === STEP_AI) {
-      checkPort(state.webPort, 'web');
-      checkPort(state.mcpPort, 'mcp');
+      checkPort(state.webPort, 'web', true);
+      checkPort(state.mcpPort, 'mcp', true);
     }
   // eslint-disable-next-line react-hooks/exhaustive-deps
   }, [step]);
@@ -259,7 +259,7 @@ export default function SetupWizard() {
     });
   }, [state.authToken]);
 
-  const checkPort = useCallback(async (port: number, which: 'web' | 'mcp') => {
+  const checkPort = useCallback(async (port: number, which: 'web' | 'mcp', autoResolve = false) => {
     if (port < 1024 || port > 65535) return;
     const setStatus = which === 'web' ? setWebPortStatus : setMcpPortStatus;
     setStatus({ checking: true, available: null, isSelf: false, suggestion: null });
@@ -270,7 +270,17 @@ export default function SetupWizard() {
         body: JSON.stringify({ port }),
       });
       const data = await res.json();
-      setStatus({ checking: false, available: data.available ?? null, isSelf: !!data.isSelf, suggestion: data.suggestion ?? null });
+      const available = data.available ?? null;
+      const suggestion = data.suggestion ?? null;
+      setStatus({ checking: false, available, isSelf: !!data.isSelf, suggestion });
+
+      // Auto-resolve: if port is occupied and a suggestion is available, use it silently
+      if (autoResolve && available === false && suggestion) {
+        const key = which === 'web' ? 'webPort' : 'mcpPort';
+        setState(prev => ({ ...prev, [key]: suggestion }));
+        // Re-check the suggested port
+        setTimeout(() => checkPort(suggestion, which, false), 0);
+      }
     } catch (e) {
       console.warn('[SetupWizard] checkPort failed:', e);
       setStatus({ checking: false, available: null, isSelf: false, suggestion: null });
@@ -380,23 +390,28 @@ export default function SetupWizard() {
   }, [agents, agentScope, agentTransport, state.mcpPort, state.authToken]);
 
   return (
-    <div className="fixed inset-0 z-50 flex items-center justify-center overflow-y-auto"
+    <div className="fixed inset-0 z-50 flex flex-col overflow-y-auto"
       role="dialog" aria-modal="true" aria-labelledby="setup-title"
       style={{ background: 'var(--background)' }}>
-      <div className="w-full max-w-xl mx-auto px-6 py-12">
-        <div className="text-center mb-8">
-          <div className="inline-flex items-center gap-2 mb-2">
-            <Sparkles size={18} style={{ color: 'var(--amber)' }} />
-            <h1 id="setup-title" className="text-2xl font-semibold tracking-tight font-display" style={{ color: 'var(--foreground)' }}>
-              MindOS
-            </h1>
+      {/* Sticky header: logo + step dots */}
+      <div className="sticky top-0 z-10 pt-6 pb-3 px-6" style={{ background: 'var(--background)' }}>
+        <div className="max-w-xl mx-auto">
+          <div className="text-center mb-3">
+            <div className="inline-flex items-center gap-2">
+              <Sparkles size={18} style={{ color: 'var(--amber)' }} />
+              <h1 id="setup-title" className="text-2xl font-semibold tracking-tight font-display" style={{ color: 'var(--foreground)' }}>
+                MindOS
+              </h1>
+            </div>
+          </div>
+          <div className="flex justify-center">
+            <StepDots step={step} setStep={setStep} stepTitles={s.stepTitles} disabled={submitting || completed} numberedSteps={STEP_REVIEW} />
           </div>
         </div>
+      </div>
 
-        <div className="flex justify-center">
-          <StepDots step={step} setStep={setStep} stepTitles={s.stepTitles} disabled={submitting || completed} numberedSteps={STEP_REVIEW} />
-        </div>
-
+      {/* Scrollable content */}
+      <div className="flex-1 w-full max-w-xl mx-auto px-6 pb-8">
         <h2 className="text-lg font-semibold mb-5" style={{ color: 'var(--foreground)' }}>
           {step === STEP_REVIEW ? `✓ ${s.stepTitles[step]}` : s.stepTitles[step]}
         </h2>

package/app/components/walkthrough/WalkthroughOverlay.tsx

@@ -68,6 +68,17 @@ export default function WalkthroughOverlay() {
     return () => window.removeEventListener('keydown', handler, true);
   }, [skipFn]);
 
+  // If target element doesn't exist (e.g. Echo not enabled), auto-skip this step
+  useEffect(() => {
+    if (!step) return;
+    const el = document.querySelector(`[data-walkthrough="${step.anchor}"]`);
+    if (!el) {
+      // Target not in DOM — skip to next step after a brief delay
+      const timer = setTimeout(() => wt?.next(), 100);
+      return () => clearTimeout(timer);
+    }
+  }, [step, wt]);
+
   if (!wt || !step) return null;
 
   // Mobile: bottom sheet instead of spotlight
@@ -98,6 +109,8 @@ export default function WalkthroughOverlay() {
             if (!inSpotlight) {
               wt.skip();
             }
+          } else {
+            wt.skip();
           }
         }}
       >

package/app/components/walkthrough/steps.ts

@@ -2,8 +2,7 @@
 export type WalkthroughAnchor =
   | 'files-panel'
   | 'ask-button'
-  | 'agents-panel'
-  | 'echo-panel';
+  | 'agents-panel';
 
 export interface WalkthroughStep {
   anchor: WalkthroughAnchor;
@@ -12,15 +11,13 @@ export interface WalkthroughStep {
 }
 
 /**
- * 4-step value-driven walkthrough aligned with the Dual-Layer Wedge strategy:
+ * 3-step value-driven walkthrough:
  *   0. Project Memory (foundation)
  *   1. AI That Already Knows You (wedge)
  *   2. Multi-Agent Sharing (differentiation)
- *   3. Echo — Cognitive Compound Interest (retention seed)
  */
 export const walkthroughSteps: WalkthroughStep[] = [
   { anchor: 'files-panel', position: 'right' },
   { anchor: 'ask-button', position: 'right' },
   { anchor: 'agents-panel', position: 'right' },
-  { anchor: 'echo-panel', position: 'right' },
 ];

package/app/lib/i18n/modules/onboarding.ts

@@ -211,10 +211,6 @@ export const onboardingEn = {
         title: 'Connect Any Agent',
         body: 'Link Cursor, Claude Code, or Windsurf via MCP — they all share the same project memory.',
       },
-      {
-        title: 'Echo — Growth Compounds',
-        body: 'About you, daily reflections, growth tracking — MindOS helps you accumulate cognitive compound interest over time.',
-      },
     ],
   },
 } as const;
@@ -430,10 +426,6 @@ export const onboardingZh = {
         title: '多 Agent 共享记忆',
         body: '通过 MCP 连接 Cursor、Claude Code、Windsurf，它们共享同一份项目记忆。',
       },
-      {
-        title: '回响 — 认知在积累',
-        body: '关于你、每日回顾、成长轨迹——MindOS 帮你沉淀判断与偏好，让经验不断复利。',
-      },
     ],
   },
 };

package/app/lib/settings.ts

@@ -181,7 +181,12 @@ export function readSettings(): ServerSettings {
       guideState: parseGuideState(parsed.guideState),
     };
   } catch {
-    return { ...DEFAULTS, ai: { ...DEFAULTS.ai, providers: { ...DEFAULTS.ai.providers } } };
+    // Config file missing or corrupt → force setup wizard
+    return {
+      ...DEFAULTS,
+      ai: { ...DEFAULTS.ai, providers: { ...DEFAULTS.ai.providers } },
+      setupPending: true,
+    };
   }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geminilight/mindos",
-  "version": "0.6.43",
+  "version": "0.6.45",
   "description": "MindOS — Human-Agent Collaborative Mind System. Local-first knowledge base that syncs your mind to all AI Agents via MCP.",
   "keywords": [
     "mindos",