@geminilight/mindos 0.6.22 → 0.6.25

package/bin/commands/space.js

@@ -0,0 +1,167 @@
+/**
+ * mindos space — Mind Space management
+ */
+
+import { existsSync, readdirSync, statSync, mkdirSync, writeFileSync } from 'node:fs';
+import { resolve, relative } from 'node:path';
+import { bold, dim, cyan, green, red } from '../lib/colors.js';
+import { loadConfig } from '../lib/config.js';
+import { output, isJsonMode } from '../lib/command.js';
+
+function getMindRoot() {
+  loadConfig();
+  const root = process.env.MIND_ROOT;
+  if (!root || !existsSync(root)) {
+    console.error(red('Mind root not configured. Run `mindos onboard` first.'));
+    process.exit(1);
+  }
+  return root;
+}
+
+export const meta = {
+  name: 'space',
+  group: 'Knowledge',
+  summary: 'Mind Space management (list, create, info)',
+  usage: 'mindos space <subcommand>',
+  examples: [
+    'mindos space list',
+    'mindos space list --json',
+    'mindos space create "Research"',
+    'mindos space info "Work"',
+  ],
+};
+
+export async function run(args, flags) {
+  const sub = args[0];
+  const root = getMindRoot();
+
+  if (!sub || flags.help || flags.h) {
+    console.log(`
+${bold('mindos space')} — Mind Space management
+
+${bold('Subcommands:')}
+  ${cyan('list'.padEnd(20))}${dim('List all spaces')}
+  ${cyan('create <name>'.padEnd(20))}${dim('Create a new space')}
+  ${cyan('info <name>'.padEnd(20))}${dim('Show space details')}
+
+${bold('Examples:')}
+  ${dim('mindos space list')}
+  ${dim('mindos space create "Research"')}
+`);
+    return;
+  }
+
+  switch (sub) {
+    case 'list': return spaceList(root, flags);
+    case 'ls': return spaceList(root, flags);
+    case 'create': return spaceCreate(root, args[1], flags);
+    case 'info': return spaceInfo(root, args[1], flags);
+    default:
+      console.error(red(`Unknown subcommand: ${sub}`));
+      console.error(dim('Available: list, create, info'));
+      process.exit(1);
+  }
+}
+
+function isSpace(dir) {
+  // A space is a top-level directory that contains an INSTRUCTION.md
+  return existsSync(resolve(dir, 'INSTRUCTION.md'));
+}
+
+function countFiles(dir) {
+  let count = 0;
+  try {
+    const entries = readdirSync(dir, { withFileTypes: true });
+    for (const e of entries) {
+      if (e.name.startsWith('.')) continue;
+      if (e.isFile()) count++;
+      else if (e.isDirectory()) count += countFiles(resolve(dir, e.name));
+    }
+  } catch { /* skip */ }
+  return count;
+}
+
+function spaceList(root, flags) {
+  const entries = readdirSync(root, { withFileTypes: true });
+  const spaces = [];
+
+  for (const e of entries) {
+    if (!e.isDirectory() || e.name.startsWith('.')) continue;
+    const full = resolve(root, e.name);
+    if (isSpace(full)) {
+      const fileCount = countFiles(full);
+      spaces.push({ name: e.name, path: e.name, fileCount });
+    }
+  }
+
+  if (isJsonMode(flags)) {
+    output({ count: spaces.length, spaces }, flags);
+    return;
+  }
+
+  if (spaces.length === 0) {
+    console.log(dim('No spaces found. Create one with: mindos space create "Name"'));
+    return;
+  }
+
+  console.log(`\n${bold(`Spaces (${spaces.length}):`)}\n`);
+  for (const s of spaces) {
+    console.log(`  ${cyan(s.name.padEnd(30))}${dim(`${s.fileCount} files`)}`);
+  }
+  console.log();
+}
+
+function spaceCreate(root, name, flags) {
+  if (!name) {
+    console.error(red('Usage: mindos space create <name>'));
+    process.exit(1);
+  }
+  const dir = resolve(root, name);
+  if (existsSync(dir)) {
+    console.error(red(`Space already exists: ${name}`));
+    process.exit(1);
+  }
+
+  mkdirSync(dir, { recursive: true });
+  writeFileSync(resolve(dir, 'INSTRUCTION.md'), `# ${name}\n\nSpace instructions go here.\n`, 'utf-8');
+
+  if (isJsonMode(flags)) {
+    output({ ok: true, name, path: name }, flags);
+    return;
+  }
+  console.log(`${green('✔')} Created space: ${cyan(name)}`);
+}
+
+function spaceInfo(root, name, flags) {
+  if (!name) {
+    console.error(red('Usage: mindos space info <name>'));
+    process.exit(1);
+  }
+  const dir = resolve(root, name);
+  if (!existsSync(dir)) {
+    console.error(red(`Space not found: ${name}`));
+    process.exit(1);
+  }
+
+  const fileCount = countFiles(dir);
+  const stat = statSync(dir);
+
+  const info = {
+    name,
+    path: name,
+    fileCount,
+    isSpace: isSpace(dir),
+    modified: stat.mtime.toISOString(),
+  };
+
+  if (isJsonMode(flags)) {
+    output(info, flags);
+    return;
+  }
+
+  console.log(`\n${bold(`Space: ${name}`)}\n`);
+  console.log(`  ${dim('Files:'.padEnd(15))}${fileCount}`);
+  console.log(`  ${dim('Is Space:'.padEnd(15))}${info.isSpace ? green('yes') : 'no (folder)'}`);
+  console.log(`  ${dim('Modified:'.padEnd(15))}${info.modified}`);
+  console.log();
+}

package/bin/commands/status.js

@@ -0,0 +1,69 @@
+/**
+ * mindos status — Show MindOS service status overview
+ */
+
+import { existsSync, readFileSync, statSync } from 'node:fs';
+import { bold, dim, cyan, green, red, yellow } from '../lib/colors.js';
+import { loadConfig } from '../lib/config.js';
+import { CONFIG_PATH, ROOT, MINDOS_DIR, LOG_PATH } from '../lib/constants.js';
+import { isPortInUse } from '../lib/port.js';
+import { output, isJsonMode } from '../lib/command.js';
+import { resolve } from 'node:path';
+
+export const meta = {
+  name: 'status',
+  group: 'Core',
+  summary: 'Show MindOS service status overview',
+  usage: 'mindos status',
+  examples: [
+    'mindos status',
+    'mindos status --json',
+  ],
+};
+
+export async function run(_args, flags) {
+  loadConfig();
+
+  const webPort = process.env.MINDOS_WEB_PORT || '3456';
+  const mcpPort = process.env.MINDOS_MCP_PORT || '8781';
+  const mindRoot = process.env.MIND_ROOT || '';
+
+  const webRunning = await isPortInUse(Number(webPort));
+  const mcpRunning = await isPortInUse(Number(mcpPort));
+
+  const pkgVersion = (() => {
+    try { return JSON.parse(readFileSync(resolve(ROOT, 'package.json'), 'utf-8')).version; } catch { return '?'; }
+  })();
+
+  const configExists = existsSync(CONFIG_PATH);
+
+  const logSize = (() => {
+    try { return statSync(LOG_PATH).size; } catch { return 0; }
+  })();
+
+  const data = {
+    version: pkgVersion,
+    configured: configExists,
+    mindRoot,
+    web: { port: webPort, running: webRunning },
+    mcp: { port: mcpPort, running: mcpRunning },
+    logSize,
+  };
+
+  if (isJsonMode(flags)) {
+    output(data, flags);
+    return;
+  }
+
+  const indicator = (ok) => ok ? green('● running') : dim('○ stopped');
+
+  console.log(`
+${bold('MindOS Status')}  ${dim(`v${pkgVersion}`)}
+
+  ${dim('Config:'.padEnd(15))}${configExists ? green('✔ configured') : red('✘ not configured')}
+  ${dim('Mind Root:'.padEnd(15))}${mindRoot ? cyan(mindRoot) : dim('not set')}
+  ${dim('Web Server:'.padEnd(15))}${indicator(webRunning)} ${dim(`(:${webPort})`)}
+  ${dim('MCP Server:'.padEnd(15))}${indicator(mcpRunning)} ${dim(`(:${mcpPort})`)}
+  ${dim('Log:'.padEnd(15))}${logSize > 0 ? dim(`${(logSize / 1024).toFixed(1)} KB`) : dim('empty')}
+`);
+}

package/bin/lib/command.js

@@ -0,0 +1,156 @@
+/**
+ * Lightweight command registry — zero dependencies.
+ *
+ * Each command exports: { meta, run }
+ *   meta.name        — primary name
+ *   meta.aliases     — optional alias names
+ *   meta.group       — help group (Core, Knowledge, MCP, Sync, Gateway, Config)
+ *   meta.summary     — one-line description
+ *   meta.usage       — usage string (optional)
+ *   meta.flags       — { flag: description } (optional)
+ *   run(args, flags) — async handler
+ */
+
+import { bold, dim, cyan, green, red } from './colors.js';
+import { ROOT } from './constants.js';
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+
+/** @type {Map<string, { meta: object, run: function }>} */
+const registry = new Map();
+
+/** @type {Map<string, string>} alias → primary name */
+const aliases = new Map();
+
+export function register(command) {
+  const { meta, run } = command;
+  registry.set(meta.name, { meta, run });
+  if (meta.aliases) {
+    for (const alias of meta.aliases) {
+      aliases.set(alias, meta.name);
+    }
+  }
+}
+
+export function resolve_command(name) {
+  if (registry.has(name)) return registry.get(name);
+  const primary = aliases.get(name);
+  if (primary) return registry.get(primary);
+  return null;
+}
+
+export function getAllCommands() {
+  return [...registry.values()];
+}
+
+/** Parse process.argv into { command, args, flags } */
+export function parseArgs(argv = process.argv.slice(2)) {
+  const flags = {};
+  const args = [];
+  let i = 0;
+
+  while (i < argv.length) {
+    const arg = argv[i];
+    if (arg.startsWith('--')) {
+      const key = arg.slice(2);
+      // Check if next arg is a value (not a flag)
+      if (i + 1 < argv.length && !argv[i + 1].startsWith('-')) {
+        flags[key] = argv[i + 1];
+        i += 2;
+      } else {
+        flags[key] = true;
+        i++;
+      }
+    } else if (arg.startsWith('-') && arg.length === 2) {
+      flags[arg.slice(1)] = true;
+      i++;
+    } else {
+      args.push(arg);
+      i++;
+    }
+  }
+
+  return { command: args[0] || null, args: args.slice(1), flags };
+}
+
+/** Check if --json flag is set */
+export function isJsonMode(flags) {
+  return flags.json === true;
+}
+
+/** Output helper: human-readable or JSON */
+export function output(data, flags) {
+  if (isJsonMode(flags)) {
+    console.log(JSON.stringify(data, null, 2));
+  } else if (typeof data === 'string') {
+    console.log(data);
+  } else {
+    console.log(JSON.stringify(data, null, 2));
+  }
+}
+
+/** Print global help */
+export function printHelp() {
+  const pkgVersion = (() => {
+    try {
+      return JSON.parse(readFileSync(resolve(ROOT, 'package.json'), 'utf-8')).version;
+    } catch { return '?'; }
+  })();
+
+  const row = (c, d) => `  ${cyan(c.padEnd(38))}${dim(d)}`;
+
+  const groups = {};
+  for (const { meta } of registry.values()) {
+    const group = meta.group || 'Other';
+    if (!groups[group]) groups[group] = [];
+    const usage = meta.usage || `mindos ${meta.name}`;
+    groups[group].push(row(usage, meta.summary));
+  }
+
+  const sections = [];
+  const groupOrder = ['Core', 'Knowledge', 'MCP', 'Sync', 'Gateway', 'Config'];
+  for (const g of groupOrder) {
+    if (groups[g]) {
+      sections.push(`${bold(`${g}:`)}\n${groups[g].join('\n')}`);
+    }
+  }
+  // Any remaining groups
+  for (const [g, items] of Object.entries(groups)) {
+    if (!groupOrder.includes(g)) {
+      sections.push(`${bold(`${g}:`)}\n${items.join('\n')}`);
+    }
+  }
+
+  console.log(`
+${bold('MindOS CLI')} ${dim(`v${pkgVersion}`)}
+
+${sections.join('\n\n')}
+
+${bold('Global Flags:')}
+  ${cyan('--json'.padEnd(38))}${dim('Output in JSON format (for agents)')}
+  ${cyan('--help, -h'.padEnd(38))}${dim('Show help')}
+  ${cyan('--version, -v'.padEnd(38))}${dim('Show version')}
+`);
+}
+
+/** Print command-specific help */
+export function printCommandHelp(cmd) {
+  const { meta } = cmd;
+  const usage = meta.usage || `mindos ${meta.name}`;
+  console.log(`\n${bold(usage)}\n`);
+  console.log(`  ${meta.summary}\n`);
+  if (meta.flags) {
+    console.log(`${bold('Flags:')}`);
+    for (const [flag, desc] of Object.entries(meta.flags)) {
+      console.log(`  ${cyan(flag.padEnd(30))}${dim(desc)}`);
+    }
+    console.log();
+  }
+  if (meta.examples) {
+    console.log(`${bold('Examples:')}`);
+    for (const ex of meta.examples) {
+      console.log(`  ${dim(ex)}`);
+    }
+    console.log();
+  }
+}

package/mcp/dist/index.cjs

@@ -107,7 +107,7 @@ data:
 
 `:r>0?`[Showing characters ${r}\u2013${r+o.length} of ${i.length}]
 
-`:"";return fe("mindos_read_file",{path:e},"ok",`${i.length} chars`),de(c+o)}catch(a){return fe("mindos_read_file",{path:e},"error",String(a)),be(String(a))}}),t.registerTool("mindos_write_file",{title:"Write File Content",description:"Overwrite the entire content of an existing file.",inputSchema:E.object({path:E.string().min(1),content:E.string()})},async({path:e,content:r})=>{try{return await dt("/api/file",{op:"save_file",path:e,content:r}),fe("mindos_write_file",{path:e},"ok",`Wrote ${r.length} chars`),de(`Successfully wrote ${r.length} characters to "${e}"`)}catch(n){return fe("mindos_write_file",{path:e},"error",String(n)),be(String(n))}}),t.registerTool("mindos_create_file",{title:"Create New File",description:"Create a new file in the knowledge base. Only .md and .csv files allowed.",inputSchema:E.object({path:E.string().min(1).regex(/\.(md|csv)$/),content:E.string().default("")})},async({path:e,content:r})=>{try{return await dt("/api/file",{op:"create_file",path:e,content:r}),fe("mindos_create_file",{path:e},"ok",`Created ${r.length} chars`),de(`Created "${e}" (${r.length} characters)`)}catch(n){return fe("mindos_create_file",{path:e},"error",String(n)),be(String(n))}}),t.registerTool("mindos_batch_create_files",{title:"Batch Create Files",description:"Create multiple new files in a single operation. Only .md and .csv files allowed. Returns a summary of created files and any errors.",inputSchema:E.object({files:E.array(E.object({path:E.string().min(1).regex(/\.(md|csv)$/).describe("Relative file path (must end in .md or .csv)"),content:E.string().default("").describe("Initial file content")})).min(1).max(50).describe("List of files to create (max 50 per call)")})},async({files:e})=>{let r=[],n=[];for(let i of e)try{await dt("/api/file",{op:"create_file",path:i.path,content:i.content}),r.push(i.path)}catch(o){n.push(`${i.path}: ${String(o)}`)}let a=`Batch creation complete.
+`:"";return fe("mindos_read_file",{path:e},"ok",`${i.length} chars`),de(c+o)}catch(a){return fe("mindos_read_file",{path:e},"error",String(a)),be(String(a))}}),t.registerTool("mindos_write_file",{title:"Write File Content",description:"Overwrite the entire content of an existing file.",inputSchema:E.object({path:E.string().min(1),content:E.string()})},async({path:e,content:r})=>{try{return await dt("/api/file",{op:"save_file",path:e,content:r}),fe("mindos_write_file",{path:e},"ok",`Wrote ${r.length} chars`),de(`Successfully wrote ${r.length} characters to "${e}"`)}catch(n){return fe("mindos_write_file",{path:e},"error",String(n)),be(String(n))}}),t.registerTool("mindos_create_file",{title:"Create New File",description:"Create a new file in the knowledge base. Only .md and .csv files allowed. Creates parent directories but does NOT create Space scaffolding. Use mindos_create_space to create a Space.",inputSchema:E.object({path:E.string().min(1).regex(/\.(md|csv)$/),content:E.string().default("")})},async({path:e,content:r})=>{try{return await dt("/api/file",{op:"create_file",path:e,content:r}),fe("mindos_create_file",{path:e},"ok",`Created ${r.length} chars`),de(`Created "${e}" (${r.length} characters)`)}catch(n){return fe("mindos_create_file",{path:e},"error",String(n)),be(String(n))}}),t.registerTool("mindos_batch_create_files",{title:"Batch Create Files",description:"Create multiple new files in a single operation. Only .md and .csv files allowed. Returns a summary of created files and any errors.",inputSchema:E.object({files:E.array(E.object({path:E.string().min(1).regex(/\.(md|csv)$/).describe("Relative file path (must end in .md or .csv)"),content:E.string().default("").describe("Initial file content")})).min(1).max(50).describe("List of files to create (max 50 per call)")})},async({files:e})=>{let r=[],n=[];for(let i of e)try{await dt("/api/file",{op:"create_file",path:i.path,content:i.content}),r.push(i.path)}catch(o){n.push(`${i.path}: ${String(o)}`)}let a=`Batch creation complete.
 Created ${r.length} file(s): ${r.join(", ")}`;return n.length>0&&(a+=`
 
 Failed to create ${n.length} file(s):

package/mcp/src/index.ts

@@ -190,7 +190,7 @@ server.registerTool("mindos_write_file", {
 
 server.registerTool("mindos_create_file", {
   title: "Create New File",
-  description: "Create a new file in the knowledge base. Only .md and .csv files allowed.",
+  description: "Create a new file in the knowledge base. Only .md and .csv files allowed. Creates parent directories but does NOT create Space scaffolding. Use mindos_create_space to create a Space.",
   inputSchema: z.object({
     path: z.string().min(1).regex(/\.(md|csv)$/),
     content: z.string().default(""),

package/package.json

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

package/skills/mindos/SKILL.md

@@ -105,8 +105,8 @@ Before any non-trivial write, confirm all checks:
 
 - `mindos_read_file`: Read file content.
 - `mindos_write_file`: Use only for true full replacement.
-- `mindos_create_file`: Create `.md`/`.csv` files.
-- `mindos_create_space`: Create a Mind Space (directory + README + INSTRUCTION scaffold). Prefer over `create_file` when adding a new cognitive zone.
+- `mindos_create_file`: Create `.md`/`.csv` files. Creates parent directories automatically but does NOT create Space scaffolding (INSTRUCTION.md/README.md). Use `mindos_create_space` when you need a Space.
+- `mindos_create_space`: Create a Mind Space (directory + README + INSTRUCTION scaffold). **This is the only way to create a Space.** Regular folders created by `create_file` remain plain directories. Use this when adding a new cognitive zone.
 - `mindos_rename_space`: Rename a Space folder (directory). Do not use `rename_file` for folders.
 - `mindos_delete_file`: Delete only with explicit user intent.
 - `mindos_rename_file`, `mindos_move_file`: Structural edits with follow-up reference checks.

package/skills/mindos-zh/SKILL.md

@@ -103,8 +103,8 @@ description: >
 
 - `mindos_read_file`：读取文件内容。
 - `mindos_write_file`：仅在确需整文件替换时使用。
-- `mindos_create_file`：创建 `.md`/`.csv` 文件。
-- `mindos_create_space`：新建心智空间（目录 + README + INSTRUCTION 脚手架）。新增整块分区时优先于只建 `某空间/README.md`。
+- `mindos_create_file`：创建 `.md`/`.csv` 文件。自动创建父目录，但不会创建空间脚手架文件（INSTRUCTION.md/README.md）。需要创建空间请用 `mindos_create_space`。
+- `mindos_create_space`：新建心智空间（目录 + README + INSTRUCTION 脚手架）。**这是创建空间的唯一方式。** 通过 `create_file` 创建的普通目录不会变成空间。新增整块知识分区时使用此工具。
 - `mindos_rename_space`：重命名空间目录（文件夹）。不能用 `rename_file` 重命名目录。
 - `mindos_delete_file`：仅在用户明确意图下删除。
 - `mindos_rename_file`、`mindos_move_file`：结构变更后补做引用检查。