@geminilight/mindos 0.6.47 → 0.6.49

package/app/app/api/ask/route.ts

@@ -225,6 +225,46 @@ function readKnowledgeFile(filePath: string): { ok: boolean; content: string; tr
   }
 }
 
+/**
+ * Resolve skill file from multiple fallback locations.
+ * Tries in order: app/data/skills → skills → {mindRoot}/.skills → ~/.mindos/skills
+ * Returns { path, result } where result is the file content or error.
+ */
+function resolveSkillFile(
+  skillName: string,
+  projectRoot: string,
+  mindRoot: string,
+): { path: string; result: ReturnType<typeof readAbsoluteFile> } {
+  const locations = [
+    // Primary: bundled location (Desktop/production builds)
+    path.join(projectRoot, 'app', 'data', 'skills', skillName, 'SKILL.md'),
+    // Fallback: repository root (dev/CLI usage)
+    path.join(projectRoot, 'skills', skillName, 'SKILL.md'),
+    // Fallback: knowledge base custom skills
+    path.join(mindRoot, '.skills', skillName, 'SKILL.md'),
+    // Fallback: global user skills
+    path.join(process.env.HOME || '/root', '.mindos', 'skills', skillName, 'SKILL.md'),
+  ];
+
+  for (const absPath of locations) {
+    const result = readAbsoluteFile(absPath);
+    if (result.ok) {
+      return { path: absPath, result };
+    }
+  }
+
+  // All locations failed — return last error
+  return {
+    path: locations[locations.length - 1],
+    result: {
+      ok: false,
+      content: '',
+      truncated: false,
+      error: `Skill not found: tried ${locations.length} locations`,
+    },
+  };
+}
+
 /**
  * In-memory cache for absolute file reads (SKILL.md, etc).
  * Keyed by absPath. Re-reads only when file mtime changes.
@@ -457,15 +497,21 @@ export async function POST(req: NextRequest) {
     // Auto-load skill + bootstrap context for each request.
     const isZh = serverSettings.disabledSkills?.includes('mindos') ?? false;
     const skillDirName = isZh ? 'mindos-zh' : 'mindos';
-    const appDir = process.env.MINDOS_PROJECT_ROOT
-      ? path.join(process.env.MINDOS_PROJECT_ROOT, 'app')
-      : process.cwd();
-    const skillPath = path.join(appDir, `data/skills/${skillDirName}/SKILL.md`);
-    const skillWritePath = path.join(appDir, `data/skills/${skillDirName}/references/write-supplement.md`);
-    const skill = readAbsoluteFile(skillPath);
+    const projectRoot = process.env.MINDOS_PROJECT_ROOT || path.resolve(process.cwd(), '..');
+    const mindRoot = getMindRoot();
+    
+    // Resolve skill file from multiple fallback locations (handles Core Update scenarios)
+    const skillInfo = resolveSkillFile(skillDirName, projectRoot, mindRoot);
+    const skill = skillInfo.result;
+    
+    // Resolve write-supplement from the same base directory as SKILL.md
+    const skillWriteDir = path.dirname(skillInfo.path);
+    const skillWritePath = path.join(skillWriteDir, 'references', 'write-supplement.md');
     const skillWrite = readAbsoluteFile(skillWritePath);
 
-    console.log(`[ask] SKILL skill=${skill.ok}, write-supplement=${skillWrite.ok}`);
+    console.log(
+      `[ask] SKILL skill=${skill.ok} (${skillInfo.path}), write-supplement=${skillWrite.ok}`
+    );
 
     const userSkillRules = readKnowledgeFile('.mindos/user-preferences.md');
 

package/app/app/api/auth/route.ts

@@ -11,6 +11,9 @@ const ALLOWED_ORIGIN_PATTERNS = [
   /^https?:\/\/localhost(:\d+)?$/,
   /^https?:\/\/127\.0\.0\.1(:\d+)?$/,
   /^https?:\/\/\[::1\](:\d+)?$/,
+  /^https?:\/\/10\.\d{1,3}\.\d{1,3}\.\d{1,3}(:\d+)?$/,
+  /^https?:\/\/172\.(1[6-9]|2\d|3[01])\.\d{1,3}\.\d{1,3}(:\d+)?$/,
+  /^https?:\/\/192\.168\.\d{1,3}\.\d{1,3}(:\d+)?$/,
   /^capacitor:\/\//,
   /^file:\/\//,
 ];

package/app/components/ask/ProviderModelCapsule.tsx

@@ -95,8 +95,10 @@ export default function ProviderModelCapsule({
     };
     doFetch();
     const onVisible = () => { if (document.visibilityState === 'visible') doFetch(); };
+    const onSettingsChanged = () => doFetch();
     document.addEventListener('visibilitychange', onVisible);
-    return () => { cancelled = true; document.removeEventListener('visibilitychange', onVisible); };
+    window.addEventListener('mindos:settings-changed', onSettingsChanged);
+    return () => { cancelled = true; document.removeEventListener('visibilitychange', onVisible); window.removeEventListener('mindos:settings-changed', onSettingsChanged); };
   }, []);
 
   const defaultProvider = (settingsData?.ai?.provider && isProviderId(settingsData.ai.provider))

package/app/components/settings/SettingsContent.tsx

@@ -124,6 +124,7 @@ export default function SettingsContent({ visible, initialTab, variant, onClose
         body: JSON.stringify({ ai: d.ai, agent: d.agent, mindRoot: d.mindRoot, webPassword: d.webPassword, authToken: d.authToken }),
       });
       setStatus('saved');
+      window.dispatchEvent(new Event('mindos:settings-changed'));
       setTimeout(() => setStatus('idle'), 2500);
     } catch {
       setStatus('error');

package/app/components/setup/StepAgents.tsx

@@ -7,6 +7,16 @@ import {
 import { Field, Select } from '@/components/settings/Primitives';
 import type { SetupMessages, McpMessages, AgentEntry, AgentInstallStatus, ConnectionMode } from './types';
 
+const AGENT_INSTALL_URLS: Record<string, string> = {
+  'claude-code': 'https://docs.anthropic.com/en/docs/claude-code/overview',
+  'cursor': 'https://www.cursor.com/',
+  'windsurf': 'https://codeium.com/windsurf',
+  'cline': 'https://github.com/cline/cline',
+  'trae': 'https://www.trae.ai/',
+  'gemini-cli': 'https://github.com/google-gemini/gemini-cli',
+  'augment': 'https://www.augmentcode.com/',
+};
+
 export interface StepAgentsProps {
   agents: AgentEntry[];
   agentsLoading: boolean;
@@ -79,10 +89,21 @@ export default function StepAgents({
         {s.agentDetected}
       </span>
     );
+    const installUrl = AGENT_INSTALL_URLS[key];
     return (
-      <span className="text-xs px-1.5 py-0.5 rounded"
-        style={{ background: 'color-mix(in srgb, var(--muted-foreground) 10%, transparent)', color: 'var(--muted-foreground)' }}>
-        {s.agentNotFound}
+      <span className="flex items-center gap-1.5">
+        <span className="text-xs px-1.5 py-0.5 rounded"
+          style={{ background: 'color-mix(in srgb, var(--muted-foreground) 10%, transparent)', color: 'var(--muted-foreground)' }}>
+          {s.agentNotFound}
+        </span>
+        {installUrl && (
+          <a href={installUrl} target="_blank" rel="noopener noreferrer"
+            onClick={e => e.stopPropagation()}
+            className="text-2xs hover:underline"
+            style={{ color: 'var(--amber)' }}>
+            {s.agentGetIt}
+          </a>
+        )}
       </span>
     );
   };

package/app/components/setup/StepReview.tsx

@@ -3,7 +3,7 @@
 import { useState, useRef, useEffect, useCallback } from 'react';
 import {
   Loader2, AlertTriangle, CheckCircle2, XCircle, Copy, Check,
-  FolderOpen, Brain, Plug, Shield,
+  FolderOpen, Brain, Plug, Shield, Sparkles,
 } from 'lucide-react';
 import { copyToClipboard } from '@/lib/clipboard';
 import { toast } from '@/lib/toast';
@@ -29,31 +29,52 @@ export function RestartBanner({ s }: { s: SetupMessages }) {
 }
 
 /** Restart button — shown in the bottom navigation bar (same position as Complete/Saving button) */
-export function RestartButton({ s, newPort }: { s: SetupMessages; newPort: number }) {
+export function RestartButton({ s, newPort, webPassword }: { s: SetupMessages; newPort: number; webPassword?: string }) {
   const [restarting, setRestarting] = useState(false);
   const [done, setDone] = useState(false);
   const pollRef = useRef<ReturnType<typeof setInterval>>(undefined);
+  const delayRef = useRef<ReturnType<typeof setTimeout>>(undefined);
 
-  // Cleanup polling interval on unmount
-  useEffect(() => () => { clearInterval(pollRef.current); }, []);
+  useEffect(() => () => { clearTimeout(delayRef.current); clearInterval(pollRef.current); }, []);
 
   const handleRestart = async () => {
     setRestarting(true);
     try {
-      await fetch('/api/restart', { method: 'POST' });
+      const restartRes = await fetch('/api/restart', { method: 'POST' });
+      if (!restartRes.ok) throw new Error(`restart failed (${restartRes.status})`);
       setDone(true);
-      const redirect = () => { window.location.href = `http://localhost:${newPort}/?welcome=1`; };
-      // Poll the new port until ready, then redirect
+      const rawHost = window.location.hostname || 'localhost';
+      const host = rawHost.includes(':') ? `[${rawHost}]` : rawHost;
+      const baseUrl = `http://${host}:${newPort}`;
+      const redirect = () => { window.location.href = `${baseUrl}/?welcome=1`; };
+
       let attempts = 0;
       clearInterval(pollRef.current);
-      pollRef.current = setInterval(async () => {
+      // Delay first poll to ensure the old server has been killed by `mindos restart`
+      const startPoll = () => { pollRef.current = setInterval(async () => {
         attempts++;
         try {
-          const r = await fetch(`http://localhost:${newPort}/api/health`);
-          if (r.status < 500) { clearInterval(pollRef.current); redirect(); return; }
+          const r = await fetch(`${baseUrl}/api/health`);
+          if (r.status < 500) {
+            clearInterval(pollRef.current);
+            // Auto-authenticate so the user doesn't have to re-enter their password
+            if (webPassword) {
+              try {
+                await fetch(`${baseUrl}/api/auth`, {
+                  method: 'POST',
+                  headers: { 'Content-Type': 'application/json' },
+                  body: JSON.stringify({ password: webPassword }),
+                  credentials: 'include',
+                });
+              } catch { /* auth failed — user will see login page instead */ }
+            }
+            redirect();
+            return;
+          }
         } catch { /* not ready yet */ }
-        if (attempts >= 10) { clearInterval(pollRef.current); redirect(); }
-      }, 800);
+        if (attempts >= 30) { clearInterval(pollRef.current); redirect(); }
+      }, 800); };
+      delayRef.current = setTimeout(startPoll, 2000);
     } catch (e) {
       console.warn('[SetupWizard] restart request failed:', e);
       setRestarting(false);
@@ -91,14 +112,15 @@ export interface StepReviewProps {
   error: string;
   needsRestart: boolean;
   s: SetupMessages;
-  setupPhase: 'review' | 'saving' | 'agents' | 'done';
+  setupPhase: 'review' | 'saving' | 'agents' | 'skills' | 'done';
   cliEnabled: boolean;
   mcpEnabled: boolean;
+  skillInstallStatus?: 'pending' | 'installing' | 'ok' | 'error' | 'skipped';
 }
 
 export default function StepReview({
   state, selectedAgents, agentStatuses, onRetryAgent, error, needsRestart, s,
-  setupPhase, cliEnabled, mcpEnabled,
+  setupPhase, cliEnabled, mcpEnabled, skillInstallStatus = 'pending',
 }: StepReviewProps) {
   const failedAgents = Object.entries(agentStatuses).filter(([, v]) => v.state === 'error');
 
@@ -113,9 +135,11 @@ export default function StepReview({
   // Progress stepper phases — dynamically built based on selected modes
   type Phase = typeof setupPhase;
   const showAgentPhase = mcpEnabled && selectedAgents.size > 0;
+  const showSkillPhase = selectedAgents.size > 0;
   const phases: { key: Phase; label: string }[] = [
     { key: 'saving', label: s.phaseSaving },
     ...(showAgentPhase ? [{ key: 'agents' as Phase, label: s.phaseAgents }] : []),
+    ...(showSkillPhase ? [{ key: 'skills' as Phase, label: s.phaseSkill ?? 'Installing skills' }] : []),
     { key: 'done', label: s.phaseDone },
   ];
   const phaseOrder: Phase[] = phases.map(p => p.key);
@@ -213,6 +237,7 @@ export default function StepReview({
           selectedAgents={selectedAgents}
           agentStatuses={agentStatuses}
           needsRestart={needsRestart}
+          skillInstallStatus={skillInstallStatus}
           s={s}
         />
       )}
@@ -222,12 +247,13 @@ export default function StepReview({
 
 /* ── Health Check Summary ─────────────────────────────────────────────────── */
 
-function HealthCheckView({ state, selectedAgents, agentStatuses, needsRestart, s }: {
+function HealthCheckView({ state, selectedAgents, agentStatuses, needsRestart, s, skillInstallStatus = 'pending' }: {
   state: SetupState;
   selectedAgents: Set<string>;
   agentStatuses: Record<string, AgentInstallStatus>;
   needsRestart: boolean;
   s: SetupMessages;
+  skillInstallStatus?: 'pending' | 'installing' | 'ok' | 'error' | 'skipped';
 }) {
   const [copied, setCopied] = useState(false);
 
@@ -251,6 +277,7 @@ function HealthCheckView({ state, selectedAgents, agentStatuses, needsRestart, s
   const successAgents = Object.values(agentStatuses).filter(a => a.state === 'ok').length;
   const agentsOk = successAgents > 0;
   const hasToken = !!state.authToken;
+  const skillsOk = skillInstallStatus === 'ok';
 
   // Resolve provider display name and model from dynamic config
   let providerDisplayName = '';
@@ -295,6 +322,19 @@ function HealthCheckView({ state, selectedAgents, agentStatuses, needsRestart, s
           : (s.healthAgentsNone ?? 'No agents configured'),
       action: agentsOk ? undefined : (s.healthAgentsAction ?? 'You can add agents later in Settings → Connections.'),
     },
+    ...(selectedAgents.size > 0 ? [{
+      ok: skillsOk,
+      icon: <Sparkles size={14} />,
+      title: s.healthSkills ?? 'Skills',
+      detail: skillInstallStatus === 'ok'
+        ? (s.healthSkillsOk ?? 'Skills installed successfully')
+        : skillInstallStatus === 'error'
+          ? (s.healthSkillsError ?? 'Skill installation failed')
+          : skillInstallStatus === 'skipped'
+            ? (s.healthSkillsSkipped ?? 'Skipped')
+            : (s.healthSkillsInstalling ?? 'Installing skills...'),
+      action: skillInstallStatus === 'error' ? (s.healthSkillsAction ?? 'You can install skills manually later.') : undefined,
+    }] : []),
   ];
 
   return (

package/app/components/setup/index.tsx

@@ -113,6 +113,30 @@ async function installAgents(
   return updated;
 }
 
+/** Phase 2.5: Install skills to selected agents. Returns success status. */
+async function installSkills(
+  skillName: string,
+  agentKeys: string[],
+): Promise<boolean> {
+  if (agentKeys.length === 0) return true;
+  
+  try {
+    const res = await fetch('/api/mcp/install-skill', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({
+        skill: skillName,
+        agents: agentKeys,
+      }),
+    });
+    const data = await res.json();
+    return data.ok === true;
+  } catch (e) {
+    console.warn('[SetupWizard] Skill installation failed:', e);
+    return false;
+  }
+}
+
 // ─── Component ───────────────────────────────────────────────────────────────
 
 export default function SetupWizard() {
@@ -138,6 +162,7 @@ export default function SetupWizard() {
   const [completed, setCompleted] = useState(false);
   const [error, setError] = useState('');
   const [needsRestart, setNeedsRestart] = useState(false);
+  const [skillInstallStatus, setSkillInstallStatus] = useState<'pending' | 'installing' | 'ok' | 'error' | 'skipped'>('pending');
 
   const [webPortStatus, setWebPortStatus] = useState<PortStatus>({ checking: false, available: null, isSelf: false, suggestion: null });
   const [mcpPortStatus, setMcpPortStatus] = useState<PortStatus>({ checking: false, available: null, isSelf: false, suggestion: null });
@@ -150,7 +175,7 @@ export default function SetupWizard() {
   const [agentScope, setAgentScope] = useState<'global' | 'project'>('global');
   const [agentStatuses, setAgentStatuses] = useState<Record<string, AgentInstallStatus>>({});
   const [connectionMode, setConnectionMode] = useState<ConnectionMode>({ cli: true, mcp: false });
-  const [setupPhase, setSetupPhase] = useState<'review' | 'saving' | 'agents' | 'done'>('review');
+  const [setupPhase, setSetupPhase] = useState<'review' | 'saving' | 'agents' | 'skills' | 'done'>('review');
 
   // Load existing config as defaults on mount, generate token if none exists
   useEffect(() => {
@@ -357,6 +382,22 @@ export default function SetupWizard() {
       }
     }
 
+    // Phase 3: Install skills to selected agents ⭐ NEW
+    if (agentKeys.length > 0) {
+      setSetupPhase('skills');
+      setSkillInstallStatus('installing');
+      const skillName = finalState.template === 'zh' ? 'mindos-zh' : 'mindos';
+      try {
+        const skillOk = await installSkills(skillName, agentKeys);
+        setSkillInstallStatus(skillOk ? 'ok' : 'error');
+      } catch (e) {
+        console.warn('[SetupWizard] skill install failed:', e);
+        setSkillInstallStatus('error');
+      }
+    } else {
+      setSkillInstallStatus('skipped');
+    }
+
     setSubmitting(false);
     setCompleted(true);
     setSetupPhase('done');
@@ -443,6 +484,7 @@ export default function SetupWizard() {
             setupPhase={setupPhase}
             cliEnabled={connectionMode.cli}
             mcpEnabled={connectionMode.mcp}
+            skillInstallStatus={skillInstallStatus}
           />
         )}
 
@@ -467,7 +509,7 @@ export default function SetupWizard() {
           ) : completed ? (
             // After completing: show Restart button or Go link
             needsRestart ? (
-              <RestartButton s={s} newPort={state.webPort} />
+              <RestartButton s={s} newPort={state.webPort} webPassword={state.webPassword} />
             ) : (
               <a href="/?welcome=1"
                 className="flex items-center gap-1.5 px-5 py-2 text-sm font-medium rounded-lg transition-colors hover:opacity-90 focus-visible:ring-2 focus-visible:ring-ring"

package/app/hooks/useAcpDetection.ts

@@ -74,6 +74,12 @@ export function useAcpDetection(): AcpDetectionState {
     setTrigger((n) => n + 1);
   }, []);
 
+  useEffect(() => {
+    const onSettingsChanged = () => refresh();
+    window.addEventListener('mindos:settings-changed', onSettingsChanged);
+    return () => window.removeEventListener('mindos:settings-changed', onSettingsChanged);
+  }, [refresh]);
+
   useEffect(() => {
     const isForce = forceRef.current;
     forceRef.current = false;

package/app/hooks/useSettingsAiAvailable.ts

@@ -9,19 +9,25 @@ export function useSettingsAiAvailable(): { ready: boolean; loading: boolean } {
 
   useEffect(() => {
     let cancelled = false;
-    fetch('/api/settings', { cache: 'no-store' })
-      .then((r) => r.json())
-      .then((d: SettingsJsonForAi) => {
-        if (!cancelled) setReady(isAiConfiguredForAsk(d));
-      })
-      .catch(() => {
-        if (!cancelled) setReady(false);
-      })
-      .finally(() => {
-        if (!cancelled) setLoading(false);
-      });
+    const doFetch = () => {
+      fetch('/api/settings', { cache: 'no-store' })
+        .then((r) => r.json())
+        .then((d: SettingsJsonForAi) => {
+          if (!cancelled) setReady(isAiConfiguredForAsk(d));
+        })
+        .catch(() => {
+          if (!cancelled) setReady(false);
+        })
+        .finally(() => {
+          if (!cancelled) setLoading(false);
+        });
+    };
+    doFetch();
+    const onChanged = () => doFetch();
+    window.addEventListener('mindos:settings-changed', onChanged);
     return () => {
       cancelled = true;
+      window.removeEventListener('mindos:settings-changed', onChanged);
     };
   }, []);
 

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

@@ -88,6 +88,7 @@ export const onboardingEn = {
     agentNotInstalled: 'not installed',
     agentDetected: 'detected',
     agentNotFound: 'not found',
+    agentGetIt: 'Get it →',
     agentStatusOk: 'configured',
     agentStatusError: 'failed',
     agentInstalling: 'Configuring…',
@@ -144,6 +145,12 @@ export const onboardingEn = {
     healthAgentsPartial: 'Configuration in progress...',
     healthAgentsNone: 'No agents configured',
     healthAgentsAction: 'You can add agents later in Settings → Connections.',
+    healthSkills: 'Skills',
+    healthSkillsOk: 'Skills installed successfully',
+    healthSkillsError: 'Skill installation failed',
+    healthSkillsSkipped: 'Skipped',
+    healthSkillsInstalling: 'Installing skills...',
+    healthSkillsAction: 'You can install skills manually later.',
     healthTokenTitle: 'Auth Token',
     healthTokenCopy: 'Copy token',
     healthTokenHint: 'Used by CLI remote mode and MCP connections. Also available in Settings → Connections.',
@@ -303,6 +310,7 @@ export const onboardingZh = {
     agentNotInstalled: '未安装',
     agentDetected: '已检测到',
     agentNotFound: '未找到',
+    agentGetIt: '去安装 →',
     agentStatusOk: '已配置',
     agentStatusError: '失败',
     agentInstalling: '配置中…',
@@ -359,6 +367,12 @@ export const onboardingZh = {
     healthAgentsPartial: '正在配置中...',
     healthAgentsNone: '未配置 Agent',
     healthAgentsAction: '可稍后在 设置 → 连接 中添加。',
+    healthSkills: 'Skills',
+    healthSkillsOk: 'Skill 安装成功',
+    healthSkillsError: 'Skill 安装失败',
+    healthSkillsSkipped: '已跳过',
+    healthSkillsInstalling: '正在安装 Skill…',
+    healthSkillsAction: '可稍后手动安装 Skill。',
     healthTokenTitle: '认证令牌',
     healthTokenCopy: '复制令牌',
     healthTokenHint: 'CLI 远程模式和 MCP 连接时使用。也可在 设置 → 连接 中找到。',

package/bin/commands/file.js

@@ -478,7 +478,22 @@ function fileAppendCsv(root, filePath, flags) {
   const line = escapeCsvRow(values) + '\n';
 
   mkdirSync(dirname(full), { recursive: true });
-  appendFileSync(full, line, 'utf-8');
+
+  let separator = '';
+  if (existsSync(full)) {
+    const stat = statSync(full);
+    if (stat.size > 0) {
+      const fd = openSync(full, 'r');
+      try {
+        const buf = Buffer.alloc(1);
+        readSync(fd, buf, 0, 1, stat.size - 1);
+        if (buf[0] !== 0x0a) separator = '\n';
+      } finally {
+        closeSync(fd);
+      }
+    }
+  }
+  appendFileSync(full, separator + line, 'utf-8');
 
   const content = readFileSync(full, 'utf-8');
   const newRowCount = content.trim().split('\n').length;

package/package.json

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

package/scripts/build-runtime-archive.sh

@@ -39,6 +39,8 @@ cp -r app/.next/static "$WORK/app/.next/static"
 # Copy public assets
 mkdir -p "$WORK/app"
 cp -r app/public "$WORK/app/public"
+# Copy skill definitions (not included in standalone output, needed at runtime)
+[ -d app/data/skills ] && cp -r app/data/skills "$WORK/app/data/skills"
 
 # ── MCP server ──
 echo "  Copying MCP..."
@@ -69,6 +71,7 @@ for f in \
   "app/.next/standalone/node_modules" \
   "app/.next/standalone/.next/server" \
   "app/.next/static" \
+  "app/data/skills" \
   "mcp/dist/index.cjs" \
   "package.json"; do
   if [ ! -e "$VERIFY/$f" ]; then