@geminilight/mindos 0.5.57 → 0.5.59

package/README.md

@@ -55,7 +55,7 @@ MindOS is where you think, and where your AI agents act — a local-first knowle
 
 **1. Global Sync — Breaking Memory Silos**
 
-Switch tools or start a new chat and you're re-transporting context, scattering knowledge. **With a built-in MCP server (20+ tools), MindOS connects all Agents to your core knowledge base with zero config. Record profile and project memory once to empower all AI tools.**
+Switch tools or start a new chat and you're re-transporting context, scattering knowledge. **With a built-in MCP server, MindOS connects all Agents to your core knowledge base with zero config. Record profile and project memory once to empower all AI tools.**
 
 **2. Transparent & Controllable — No Black Boxes**
 

package/README_zh.md

@@ -55,7 +55,7 @@ MindOS 是你思考的地方，也是 AI Agent 行动的起点——一个你和
 
 **1. 全局同步 — 打破记忆割裂**
 
-切换工具带来上下文割裂，个人深度背景散落各处，导致知识无法复用。**MindOS 内置 MCP Server (支持 20+ 工具)，所有 Agent 零配置直连核心知识库。项目记忆与 SOP 仅需一处记录，全局赋能所有 AI 工具。**
+切换工具带来上下文割裂，个人深度背景散落各处，导致知识无法复用。**MindOS 内置 MCP Server，所有 Agent 零配置直连核心知识库。项目记忆与 SOP 仅需一处记录，全局赋能所有 AI 工具。**
 
 **2. 透明可控 — 消除记忆黑箱**
 

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

@@ -182,7 +182,10 @@ export async function POST(req: NextRequest) {
   // 2. user-skill-rules.md — user's personalized rules from KB root (if exists)
   const isZh = serverSettings.disabledSkills?.includes('mindos') ?? false;
   const skillDirName = isZh ? 'mindos-zh' : 'mindos';
-  const skillPath = path.resolve(process.cwd(), `data/skills/${skillDirName}/SKILL.md`);
+  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 skill = readAbsoluteFile(skillPath);
 
   const mindRoot = getMindRoot();

package/app/app/api/extract-pdf/route.ts

@@ -27,8 +27,10 @@ function extractPdf(buf: Buffer): { text: string; pages: number } {
   // Write PDF to a temp file so the child script can read it.
   const tmpDir = os.tmpdir();
   const tmpPdf = path.join(tmpDir, `pdf-extract-${Date.now()}.pdf`);
-  // Dynamic path construction to prevent Turbopack static analysis
-  const scriptPath = [process.cwd(), 'scripts', 'extract-pdf.cjs'].join(path.sep);
+  const appDir = process.env.MINDOS_PROJECT_ROOT
+    ? path.join(process.env.MINDOS_PROJECT_ROOT, 'app')
+    : process.cwd();
+  const scriptPath = path.join(appDir, 'scripts', 'extract-pdf.cjs');
 
   fs.writeFileSync(tmpPdf, buf);
   try {

package/app/app/api/file/route.ts

@@ -13,18 +13,32 @@ import {
   updateSection,
   deleteFile,
   renameFile,
+  renameSpace,
   moveFile,
   appendCsvRow,
+  getMindRoot,
+  invalidateCache,
+  listMindSpaces,
 } from '@/lib/fs';
+import { createSpaceFilesystem } from '@/lib/core/create-space';
 
 function err(msg: string, status = 400) {
   return NextResponse.json({ error: msg }, { status });
 }
 
-// GET /api/file?path=foo.md&op=read_file|read_lines
+// GET /api/file?path=foo.md&op=read_file|read_lines | GET ?op=list_spaces (no path)
 export async function GET(req: NextRequest) {
   const filePath = req.nextUrl.searchParams.get('path');
   const op = req.nextUrl.searchParams.get('op') ?? 'read_file';
+
+  if (op === 'list_spaces') {
+    try {
+      return NextResponse.json({ spaces: listMindSpaces() });
+    } catch (e) {
+      return err((e as Error).message, 500);
+    }
+  }
+
   if (!filePath) return err('missing path');
 
   try {
@@ -39,7 +53,14 @@ export async function GET(req: NextRequest) {
 }
 
 // Ops that change file tree structure (sidebar needs refresh)
-const TREE_CHANGING_OPS = new Set(['create_file', 'delete_file', 'rename_file', 'move_file']);
+const TREE_CHANGING_OPS = new Set([
+  'create_file',
+  'delete_file',
+  'rename_file',
+  'move_file',
+  'create_space',
+  'rename_space',
+]);
 
 // POST /api/file  body: { op, path, ...params }
 export async function POST(req: NextRequest) {
@@ -138,6 +159,37 @@ export async function POST(req: NextRequest) {
         break;
       }
 
+      case 'create_space': {
+        const name = params.name;
+        const description = typeof params.description === 'string' ? params.description : '';
+        const parent_path = typeof params.parent_path === 'string' ? params.parent_path : '';
+        if (typeof name !== 'string' || !name.trim()) {
+          return err('missing or empty name');
+        }
+        try {
+          const { path: spacePath } = createSpaceFilesystem(getMindRoot(), name, description, parent_path);
+          invalidateCache();
+          resp = NextResponse.json({ ok: true, path: spacePath });
+        } catch (e) {
+          const msg = (e as Error).message;
+          const code400 =
+            msg.includes('required') ||
+            msg.includes('must not contain') ||
+            msg.includes('Invalid parent') ||
+            msg.includes('already exists');
+          return err(msg, code400 ? 400 : 500);
+        }
+        break;
+      }
+
+      case 'rename_space': {
+        const { new_name } = params as { new_name: string };
+        if (typeof new_name !== 'string' || !new_name.trim()) return err('missing new_name');
+        const newPath = renameSpace(filePath, new_name.trim());
+        resp = NextResponse.json({ ok: true, newPath });
+        break;
+      }
+
       case 'append_csv': {
         const { row } = params as { row: string[] };
         if (!Array.isArray(row) || row.length === 0) return err('row must be non-empty array');

package/app/app/api/health/route.ts

@@ -11,8 +11,10 @@ function readVersion(): string {
   // 1. Env var set by CLI (most reliable)
   if (process.env.npm_package_version) return process.env.npm_package_version;
 
-  // 2. Try known relative paths from Next.js app directory
+  // 2. Try known relative paths — MINDOS_PROJECT_ROOT is reliable in standalone mode
+  const projRoot = process.env.MINDOS_PROJECT_ROOT;
   const candidates = [
+    ...(projRoot ? [join(projRoot, 'package.json')] : []),
     join(process.cwd(), '..', 'package.json'),    // dev: app/ → root
     join(process.cwd(), 'package.json'),           // if cwd is root
     join(dirname(process.cwd()), 'package.json'),  // standalone edge case

package/app/app/api/mcp/install-skill/route.ts

@@ -36,9 +36,11 @@ const AGENT_NAME_MAP: Record<string, string> = {
 
 /** Fallback: find local skills directory for offline installs */
 function findLocalSkillsDir(): string | null {
+  const projRoot = process.env.MINDOS_PROJECT_ROOT || path.resolve(process.cwd(), '..');
   const candidates = [
-    path.resolve(process.cwd(), 'data/skills'),   // app/data/skills/
-    path.resolve(process.cwd(), '..', 'skills'),   // project-root/skills/
+    path.resolve(process.cwd(), 'data/skills'),       // app/data/skills/
+    path.join(projRoot, 'skills'),                     // project-root/skills/
+    path.join(projRoot, 'app', 'data', 'skills'),      // standalone fallback
   ];
   for (const dir of candidates) {
     if (fs.existsSync(dir)) return dir;

package/app/app/api/mcp/restart/route.ts

@@ -57,7 +57,7 @@ export async function POST() {
     await new Promise(r => setTimeout(r, 1000));
 
     // Step 3: Spawn new MCP server
-    const root = resolve(process.cwd(), '..');
+    const root = process.env.MINDOS_PROJECT_ROOT || resolve(process.cwd(), '..');
     const mcpDir = resolve(root, 'mcp');
 
     if (!existsSync(resolve(mcpDir, 'node_modules'))) {

package/app/app/api/restart/route.ts

@@ -5,7 +5,7 @@ import { resolve } from 'node:path';
 
 export async function POST() {
   try {
-    const cliPath = process.env.MINDOS_CLI_PATH || resolve(process.cwd(), '..', 'bin', 'cli.js');
+    const cliPath = process.env.MINDOS_CLI_PATH || resolve(process.env.MINDOS_PROJECT_ROOT || process.cwd(), '..', 'bin', 'cli.js');
     const nodeBin = process.env.MINDOS_NODE_BIN || process.execPath;
     // Use 'restart' (stop all → wait for ports free → start) instead of bare
     // 'start' which would fail assertPortFree because the current process and

package/app/app/api/skills/route.ts

@@ -5,7 +5,7 @@ import path from 'path';
 import os from 'os';
 import { readSettings, writeSettings } from '@/lib/settings';
 
-const PROJECT_ROOT = path.resolve(process.cwd(), '..');
+const PROJECT_ROOT = process.env.MINDOS_PROJECT_ROOT || path.resolve(process.cwd(), '..');
 
 function getMindRoot(): string {
   const s = readSettings();

package/app/app/api/sync/route.ts

@@ -37,9 +37,9 @@ function isGitRepo(dir: string) {
   return existsSync(join(dir, '.git'));
 }
 
-/** Resolve path to bin/cli.js — prefer env var set by CLI launcher, fall back to cwd. */
+/** Resolve path to bin/cli.js — prefer env var set by CLI launcher, fall back to project root. */
 function getCliPath() {
-  return process.env.MINDOS_CLI_PATH || resolve(process.cwd(), '..', 'bin', 'cli' + '.js');
+  return process.env.MINDOS_CLI_PATH || resolve(process.env.MINDOS_PROJECT_ROOT || process.cwd(), '..', 'bin', 'cli' + '.js');
 }
 
 /** Run CLI command via execFile — avoids shell injection by passing args as array */

package/app/app/api/update/route.ts

@@ -12,7 +12,7 @@ import { resolve } from 'node:path';
  */
 export async function POST() {
   try {
-    const cliPath = process.env.MINDOS_CLI_PATH || resolve(process.cwd(), '..', 'bin', 'cli.js');
+    const cliPath = process.env.MINDOS_CLI_PATH || resolve(process.env.MINDOS_PROJECT_ROOT || process.cwd(), '..', 'bin', 'cli.js');
     const nodeBin = process.env.MINDOS_NODE_BIN || process.execPath;
 
     // Strip MINDOS_* env vars so the child reads fresh config

package/app/app/api/update-check/route.ts

@@ -7,9 +7,17 @@ import { resolve } from 'path';
 // Read version from package.json (not process.env.npm_package_version — unavailable in daemon mode)
 let current = '0.0.0';
 try {
-  const pkgPath = resolve(process.cwd(), '..', 'package.json');
-  const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
-  current = pkg.version;
+  const projRoot = process.env.MINDOS_PROJECT_ROOT;
+  const candidates = [
+    ...(projRoot ? [resolve(projRoot, 'package.json')] : []),
+    resolve(process.cwd(), '..', 'package.json'),
+  ];
+  for (const p of candidates) {
+    try {
+      const pkg = JSON.parse(readFileSync(p, 'utf-8'));
+      if (pkg.version) { current = pkg.version; break; }
+    } catch { /* try next */ }
+  }
 } catch {}
 
 // npm registry sources: prefer China mirror, fallback to official

package/app/app/globals.css

@@ -422,3 +422,7 @@ a:focus-visible,
 .wysiwyg-wrapper:focus-within {
   outline: none;
 }
+
+/* macOS Electron: traffic-light safe zone. Actual CSS is injected by Electron
+   main process via webContents.insertCSS(); this is a no-op fallback. */
+.electron-mac-titlebar-pad { display: none; }

package/app/app/layout.tsx

@@ -88,6 +88,12 @@ export default async function RootLayout({
             __html: `(function(){if(typeof Node!=='undefined'){var o=Node.prototype.removeChild;Node.prototype.removeChild=function(c){if(c.parentNode!==this){try{return o.call(c.parentNode,c)}catch(e){return c}}return o.call(this,c)};var i=Node.prototype.insertBefore;Node.prototype.insertBefore=function(n,r){if(r&&r.parentNode!==this){try{return i.call(r.parentNode,n,r)}catch(e){return i.call(this,n,null)}}return i.call(this,n,r)}}})();`,
           }}
         />
+        {/* Electron macOS: set data-electron-mac before first paint so sidebar clears traffic lights */}
+        <script
+          dangerouslySetInnerHTML={{
+            __html: `(function(){try{if(/electron/i.test(navigator.userAgent)&&/macintosh/i.test(navigator.userAgent)){document.documentElement.setAttribute('data-electron-mac','')}}catch(e){}})();`,
+          }}
+        />
         {/* Apply user appearance settings before first paint, preventing flash */}
         <script
           dangerouslySetInnerHTML={{

package/app/app/login/page.tsx

@@ -118,9 +118,20 @@ function LoginForm() {
   );
 }
 
+function LoginFallback() {
+  return (
+    <div className="min-h-screen bg-background flex items-center justify-center px-4">
+      <div className="flex flex-col items-center gap-3 text-muted-foreground">
+        <Loader2 className="h-8 w-8 animate-spin text-[var(--amber)]" aria-hidden />
+        <p className="text-sm">Loading…</p>
+      </div>
+    </div>
+  );
+}
+
 export default function LoginPage() {
   return (
-    <Suspense>
+    <Suspense fallback={<LoginFallback />}>
       <LoginForm />
     </Suspense>
   );

package/app/app/register-sw.tsx

@@ -4,6 +4,10 @@ import { useEffect } from 'react';
 
 export default function RegisterSW() {
   useEffect(() => {
+    // Electron embedded Chromium: SW can leave the UI blank or stall hydration; skip.
+    if (typeof navigator !== 'undefined' && /electron/i.test(navigator.userAgent)) {
+      return;
+    }
     if ('serviceWorker' in navigator) {
       navigator.serviceWorker.register('/sw.js').catch((err) => {
         console.warn('[SW] Registration failed:', err);

package/app/app/view/[...path]/page.tsx

@@ -1,5 +1,5 @@
 import { notFound } from 'next/navigation';
-import { getFileContent, saveFileContent, isDirectory, getDirEntries, createFile, getFileTree } from '@/lib/fs';
+import { getFileContent, saveFileContent, isDirectory, getDirEntries, createFile, getFileTree, getSpacePreview } from '@/lib/fs';
 import type { FileNode } from '@/lib/types';
 import ViewPageClient from './ViewPageClient';
 import DirView from '@/components/DirView';
@@ -24,10 +24,10 @@ export default async function ViewPage({ params }: PageProps) {
   const { path: segments } = await params;
   const filePath = segments.map(decodeURIComponent).join('/');
 
-  // Directory: show folder listing
   if (isDirectory(filePath)) {
     const entries = getDirEntries(filePath);
-    return <DirView dirPath={filePath} entries={entries} />;
+    const spacePreview = getSpacePreview(filePath);
+    return <DirView dirPath={filePath} entries={entries} spacePreview={spacePreview} />;
   }
 
   const extension = filePath.split('.').pop()?.toLowerCase() || '';

package/app/components/DirView.tsx

@@ -1,16 +1,20 @@
 'use client';
 
-import { useState, useSyncExternalStore, useMemo } from 'react';
+import { useSyncExternalStore, useMemo } from 'react';
 import Link from 'next/link';
-import { FileText, Table, Folder, FolderOpen, LayoutGrid, List, FilePlus } from 'lucide-react';
+import { FileText, Table, Folder, FolderOpen, LayoutGrid, List, FilePlus, ScrollText, BookOpen } from 'lucide-react';
 import Breadcrumb from '@/components/Breadcrumb';
 import { encodePath, relativeTime } from '@/lib/utils';
 import { FileNode } from '@/lib/types';
+import type { SpacePreview } from '@/lib/core/types';
 import { useLocale } from '@/lib/LocaleContext';
 
+const SYSTEM_FILES = new Set(['INSTRUCTION.md', 'README.md']);
+
 interface DirViewProps {
   dirPath: string;
   entries: FileNode[];
+  spacePreview?: SpacePreview | null;
 }
 
 function FileIcon({ node }: { node: FileNode }) {
@@ -54,15 +58,94 @@ function useDirViewPref() {
   return [view, setView] as const;
 }
 
-export default function DirView({ dirPath, entries }: DirViewProps) {
+// ─── Space Preview Cards ──────────────────────────────────────────────────────
+
+function SpacePreviewCard({ icon, title, lines, viewAllHref, viewAllLabel }: {
+  icon: React.ReactNode;
+  title: string;
+  lines: string[];
+  viewAllHref: string;
+  viewAllLabel: string;
+}) {
+  if (lines.length === 0) return null;
+  return (
+    <div className="bg-muted/30 border border-border/40 rounded-lg px-4 py-3">
+      <div className="flex items-center gap-1.5 mb-2">
+        {icon}
+        <span className="text-sm font-medium text-muted-foreground">{title}</span>
+      </div>
+      <div className="space-y-1">
+        {lines.map((line, i) => (
+          <p key={i} className="text-sm text-muted-foreground/80 leading-relaxed">
+            · {line}
+          </p>
+        ))}
+      </div>
+      <div className="flex justify-end mt-2">
+        <Link
+          href={viewAllHref}
+          className="text-xs hover:underline transition-colors"
+          style={{ color: 'var(--amber)' }}
+        >
+          {viewAllLabel}
+        </Link>
+      </div>
+    </div>
+  );
+}
+
+function SpacePreviewSection({ preview, dirPath }: {
+  preview: SpacePreview;
+  dirPath: string;
+}) {
+  const { t } = useLocale();
+  const hasRules = preview.instructionLines.length > 0;
+  const hasAbout = preview.readmeLines.length > 0;
+  if (!hasRules && !hasAbout) return null;
+
+  return (
+    <div className="grid grid-cols-1 sm:grid-cols-2 gap-3 mb-6">
+      {hasRules && (
+        <SpacePreviewCard
+          icon={<ScrollText size={14} className="text-muted-foreground shrink-0" />}
+          title={t.fileTree.rules}
+          lines={preview.instructionLines}
+          viewAllHref={`/view/${encodePath(`${dirPath}/INSTRUCTION.md`)}`}
+          viewAllLabel={t.fileTree.viewAll}
+        />
+      )}
+      {hasAbout && (
+        <SpacePreviewCard
+          icon={<BookOpen size={14} className="text-muted-foreground shrink-0" />}
+          title={t.fileTree.about}
+          lines={preview.readmeLines}
+          viewAllHref={`/view/${encodePath(`${dirPath}/README.md`)}`}
+          viewAllLabel={t.fileTree.viewAll}
+        />
+      )}
+    </div>
+  );
+}
+
+// ─── DirView ──────────────────────────────────────────────────────────────────
+
+export default function DirView({ dirPath, entries, spacePreview }: DirViewProps) {
   const [view, setView] = useDirViewPref();
   const { t } = useLocale();
   const formatTime = (mtime: number) => relativeTime(mtime, t.home.relativeTime);
+
+  const visibleEntries = useMemo(() => {
+    if (spacePreview) {
+      return entries.filter(e => e.type !== 'file' || !SYSTEM_FILES.has(e.name));
+    }
+    return entries.filter(e => e.type !== 'file' || e.name !== 'README.md');
+  }, [entries, spacePreview]);
+
   const fileCounts = useMemo(() => {
     const map = new Map<string, number>();
-    for (const e of entries) map.set(e.path, countFiles(e));
+    for (const e of visibleEntries) map.set(e.path, countFiles(e));
     return map;
-  }, [entries]);
+  }, [visibleEntries]);
 
   return (
     <div className="flex flex-col min-h-screen">
@@ -72,7 +155,6 @@ export default function DirView({ dirPath, entries }: DirViewProps) {
           <div className="min-w-0 flex-1">
             <Breadcrumb filePath={dirPath} />
           </div>
-          {/* New file + View toggle */}
           <div className="flex items-center gap-2 shrink-0">
             <Link
               href={`/view/${encodePath(dirPath ? `${dirPath}/Untitled.md` : 'Untitled.md')}`}
@@ -104,11 +186,16 @@ export default function DirView({ dirPath, entries }: DirViewProps) {
       {/* Content */}
       <div className="flex-1 px-4 md:px-6 py-6">
         <div className="max-w-[860px] mx-auto">
-          {entries.length === 0 ? (
+          {/* Space preview cards */}
+          {spacePreview && (
+            <SpacePreviewSection preview={spacePreview} dirPath={dirPath} />
+          )}
+
+          {visibleEntries.length === 0 ? (
             <p className="text-muted-foreground text-sm">{t.dirView.emptyFolder}</p>
           ) : view === 'grid' ? (
             <div className="grid grid-cols-2 sm:grid-cols-3 md:grid-cols-4 xl:grid-cols-5 gap-3">
-              {entries.map(entry => (
+              {visibleEntries.map(entry => (
                 <Link
                   key={entry.path}
                   href={`/view/${encodePath(entry.path)}`}
@@ -137,7 +224,7 @@ export default function DirView({ dirPath, entries }: DirViewProps) {
             </div>
           ) : (
             <div className="flex flex-col divide-y divide-border border border-border rounded-xl overflow-hidden">
-              {entries.map(entry => (
+              {visibleEntries.map(entry => (
                 <Link
                   key={entry.path}
                   href={`/view/${encodePath(entry.path)}`}