@geminilight/mindos 0.6.39 → 0.6.40

package/mcp/package.json

@@ -10,12 +10,12 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.25.0",
-    "tsx": "^4.19.0",
     "zod": "^3.23.8"
   },
   "devDependencies": {
     "@types/node": "^22",
     "esbuild": "^0.25.0",
+    "tsx": "^4.19.0",
     "typescript": "^5"
   }
 }

package/mcp/src/index.ts

@@ -30,31 +30,33 @@ const MCP_PORT       = parseInt(process.env.MCP_PORT ?? "8781", 10);
 const MCP_ENDPOINT   = process.env.MCP_ENDPOINT    ?? "/mcp";
 const CHARACTER_LIMIT = 25_000;
 
-function headers(): Record<string, string> {
+function headers(agentName?: string): Record<string, string> {
   const h: Record<string, string> = { "Content-Type": "application/json" };
   if (AUTH_TOKEN) h["Authorization"] = `Bearer ${AUTH_TOKEN}`;
+  // Sanitize: strip control chars, limit to 100 chars
+  if (agentName) h["x-mindos-agent"] = agentName.replace(/[\x00-\x1f]/g, '').slice(0, 100);
   return h;
 }
 
 // ─── HTTP helpers ────────────────────────────────────────────────────────────
 
-async function get(path: string, params?: Record<string, string>): Promise<Record<string, unknown>> {
+async function get(path: string, params?: Record<string, string>, agentName?: string): Promise<Record<string, unknown>> {
   const url = new URL(path, BASE_URL);
   if (params) {
     for (const [k, v] of Object.entries(params)) {
       if (v !== undefined && v !== null) url.searchParams.set(k, v);
     }
   }
-  const res = await fetch(url.toString(), { headers: headers() });
+  const res = await fetch(url.toString(), { headers: headers(agentName) });
   const json = await res.json() as Record<string, unknown>;
   if (!res.ok) throw new Error((json.error as string) ?? `HTTP ${res.status}`);
   return json;
 }
 
-async function post(path: string, body: Record<string, unknown>): Promise<Record<string, unknown>> {
+async function post(path: string, body: Record<string, unknown>, agentName?: string): Promise<Record<string, unknown>> {
   const res = await fetch(new URL(path, BASE_URL).toString(), {
     method: "POST",
-    headers: headers(),
+    headers: headers(agentName),
     body: JSON.stringify(body),
   });
   const json = await res.json() as Record<string, unknown>;
@@ -77,14 +79,14 @@ function truncate(text: string, limit = CHARACTER_LIMIT): string {
 
 // ─── Agent operation logging ────────────────────────────────────────────────
 
-async function logOp(tool: string, params: Record<string, unknown>, result: 'ok' | 'error', message: string) {
+async function logOp(tool: string, params: Record<string, unknown>, result: 'ok' | 'error', message: string, agentName?: string) {
   try {
-    const entry = { ts: new Date().toISOString(), tool, params, result, message: message.slice(0, 200) };
+    const entry = { ts: new Date().toISOString(), tool, params, result, message: message.slice(0, 200), agentName: agentName || undefined };
     const line = JSON.stringify(entry) + '\n';
     // Append to .agent-log.json via the app API
     await fetch(new URL("/api/file", BASE_URL).toString(), {
       method: "POST",
-      headers: headers(),
+      headers: headers(agentName),
       body: JSON.stringify({ op: "append_to_file", path: ".agent-log.json", content: line }),
     }).catch(() => {});
   } catch {
@@ -96,6 +98,17 @@ async function logOp(tool: string, params: Record<string, unknown>, result: 'ok'
 
 function registerTools(server: McpServer) {
 
+/** Get the MCP client name for this server session (e.g. "claude-code", "cursor"). */
+function clientName(): string | undefined {
+  return server.server.getClientVersion()?.name || undefined;
+}
+
+// Session-aware wrappers that auto-inject client identity into every API call
+const _get = (path: string, params?: Record<string, string>) => get(path, params, clientName());
+const _post = (path: string, body: Record<string, unknown>) => post(path, body, clientName());
+const _logOp = (tool: string, params: Record<string, unknown>, result: 'ok' | 'error', msg: string) =>
+  logOp(tool, params, result, msg, clientName());
+
 // ── mindos_list_files ───────────────────────────────────────────────────────
 
 server.registerTool("mindos_list_files", {
@@ -107,11 +120,11 @@ server.registerTool("mindos_list_files", {
   annotations: { readOnlyHint: true },
 }, async ({ response_format }) => {
   try {
-    const json = await get("/api/files", { format: response_format });
+    const json = await _get("/api/files", { format: response_format });
     const result = typeof json.tree === "string" ? json.tree : JSON.stringify(json.tree ?? json, null, 2);
-    logOp("mindos_list_files", { response_format }, "ok", `${result.length} chars`);
+    _logOp("mindos_list_files", { response_format }, "ok", `${result.length} chars`);
     return ok(result);
-  } catch (e) { logOp("mindos_list_files", { response_format }, "error", String(e)); return error(String(e)); }
+  } catch (e) { _logOp("mindos_list_files", { response_format }, "error", String(e)); return error(String(e)); }
 });
 
 // ── mindos_list_spaces ──────────────────────────────────────────────────────
@@ -126,20 +139,20 @@ server.registerTool("mindos_list_spaces", {
   annotations: { readOnlyHint: true },
 }, async ({ response_format }) => {
   try {
-    const json = await get("/api/file", { op: "list_spaces" });
+    const json = await _get("/api/file", { op: "list_spaces" });
     const spaces = json.spaces as Array<{ name: string; path: string; fileCount: number; description: string }>;
     if (response_format === "json") {
-      logOp("mindos_list_spaces", { response_format }, "ok", `${spaces?.length ?? 0} spaces`);
+      _logOp("mindos_list_spaces", { response_format }, "ok", `${spaces?.length ?? 0} spaces`);
       return ok(JSON.stringify({ spaces: spaces ?? [] }, null, 2));
     }
     const lines = (spaces ?? []).map(
       (s) => `- **${s.name}** (\`${s.path}/\`) — ${s.fileCount} file(s)${s.description ? ` — ${s.description}` : ""}`,
     );
     const text = lines.length ? lines.join("\n") : "(no top-level spaces in tree)";
-    logOp("mindos_list_spaces", { response_format }, "ok", `${spaces?.length ?? 0} spaces`);
+    _logOp("mindos_list_spaces", { response_format }, "ok", `${spaces?.length ?? 0} spaces`);
     return ok(text);
   } catch (e) {
-    logOp("mindos_list_spaces", { response_format }, "error", String(e));
+    _logOp("mindos_list_spaces", { response_format }, "error", String(e));
     return error(String(e));
   }
 });
@@ -157,16 +170,16 @@ server.registerTool("mindos_read_file", {
   annotations: { readOnlyHint: true },
 }, async ({ path, offset, limit }) => {
   try {
-    const json = await get("/api/file", { path, op: "read_file" });
+    const json = await _get("/api/file", { path, op: "read_file" });
     const content = json.content as string;
     const slice = content.slice(offset, offset + limit);
     const hasMore = offset + limit < content.length;
     const header = hasMore
       ? `[Showing characters ${offset}–${offset + slice.length} of ${content.length}. Use offset=${offset + limit} for next page.]\n\n`
       : offset > 0 ? `[Showing characters ${offset}–${offset + slice.length} of ${content.length}]\n\n` : "";
-    logOp("mindos_read_file", { path }, "ok", `${content.length} chars`);
+    _logOp("mindos_read_file", { path }, "ok", `${content.length} chars`);
     return ok(header + slice);
-  } catch (e) { logOp("mindos_read_file", { path }, "error", String(e)); return error(String(e)); }
+  } catch (e) { _logOp("mindos_read_file", { path }, "error", String(e)); return error(String(e)); }
 });
 
 // ── mindos_write_file ───────────────────────────────────────────────────────
@@ -180,10 +193,10 @@ server.registerTool("mindos_write_file", {
   }),
 }, async ({ path, content }) => {
   try {
-    await post("/api/file", { op: "save_file", path, content });
-    logOp("mindos_write_file", { path }, "ok", `Wrote ${content.length} chars`);
+    await _post("/api/file", { op: "save_file", path, content });
+    _logOp("mindos_write_file", { path }, "ok", `Wrote ${content.length} chars`);
     return ok(`Successfully wrote ${content.length} characters to "${path}"`);
-  } catch (e) { logOp("mindos_write_file", { path }, "error", String(e)); return error(String(e)); }
+  } catch (e) { _logOp("mindos_write_file", { path }, "error", String(e)); return error(String(e)); }
 });
 
 // ── mindos_create_file ──────────────────────────────────────────────────────
@@ -197,10 +210,10 @@ server.registerTool("mindos_create_file", {
   }),
 }, async ({ path, content }) => {
   try {
-    await post("/api/file", { op: "create_file", path, content });
-    logOp("mindos_create_file", { path }, "ok", `Created ${content.length} chars`);
+    await _post("/api/file", { op: "create_file", path, content });
+    _logOp("mindos_create_file", { path }, "ok", `Created ${content.length} chars`);
     return ok(`Created "${path}" (${content.length} characters)`);
-  } catch (e) { logOp("mindos_create_file", { path }, "error", String(e)); return error(String(e)); }
+  } catch (e) { _logOp("mindos_create_file", { path }, "error", String(e)); return error(String(e)); }
 });
 
 // ── mindos_batch_create_files ────────────────────────────────────────────────
@@ -220,7 +233,7 @@ server.registerTool("mindos_batch_create_files", {
   const errors: string[] = [];
   for (const file of files) {
     try {
-      await post("/api/file", { op: "create_file", path: file.path, content: file.content });
+      await _post("/api/file", { op: "create_file", path: file.path, content: file.content });
       created.push(file.path);
     } catch (e) {
       errors.push(`${file.path}: ${String(e)}`);
@@ -228,7 +241,7 @@ server.registerTool("mindos_batch_create_files", {
   }
   let msg = `Batch creation complete.\nCreated ${created.length} file(s): ${created.join(", ")}`;
   if (errors.length > 0) msg += `\n\nFailed to create ${errors.length} file(s):\n${errors.join("\n")}`;
-  logOp("mindos_batch_create_files", { count: files.length }, created.length === files.length ? "ok" : "error", msg.slice(0, 200));
+  _logOp("mindos_batch_create_files", { count: files.length }, created.length === files.length ? "ok" : "error", msg.slice(0, 200));
   return created.length === files.length ? ok(msg) : error(msg);
 });
 
@@ -245,7 +258,7 @@ server.registerTool("mindos_create_space", {
   }),
 }, async ({ name, description, parent_path }) => {
   try {
-    const json = await post("/api/file", {
+    const json = await _post("/api/file", {
       op: "create_space",
       path: "_",
       name,
@@ -253,10 +266,10 @@ server.registerTool("mindos_create_space", {
       parent_path,
     });
     const p = json.path as string;
-    logOp("mindos_create_space", { name, parent_path }, "ok", p);
+    _logOp("mindos_create_space", { name, parent_path }, "ok", p);
     return ok(`Created Mind Space at "${p}"`);
   } catch (e) {
-    logOp("mindos_create_space", { name, parent_path }, "error", String(e));
+    _logOp("mindos_create_space", { name, parent_path }, "error", String(e));
     return error(String(e));
   }
 });
@@ -273,11 +286,11 @@ server.registerTool("mindos_rename_space", {
   }),
 }, async ({ path: spacePath, new_name }) => {
   try {
-    const json = await post("/api/file", { op: "rename_space", path: spacePath, new_name });
-    logOp("mindos_rename_space", { path: spacePath, new_name }, "ok", String(json.newPath));
+    const json = await _post("/api/file", { op: "rename_space", path: spacePath, new_name });
+    _logOp("mindos_rename_space", { path: spacePath, new_name }, "ok", String(json.newPath));
     return ok(`Renamed space "${spacePath}" → "${json.newPath}"`);
   } catch (e) {
-    logOp("mindos_rename_space", { path: spacePath, new_name }, "error", String(e));
+    _logOp("mindos_rename_space", { path: spacePath, new_name }, "error", String(e));
     return error(String(e));
   }
 });
@@ -286,17 +299,18 @@ server.registerTool("mindos_rename_space", {
 
 server.registerTool("mindos_delete_file", {
   title: "Delete File",
-  description: "Permanently delete a file from the knowledge base.",
+  description: "Delete a file from the knowledge base. The file is moved to trash and can be recovered within 30 days.",
   inputSchema: z.object({
     path: z.string().min(1),
   }),
   annotations: { destructiveHint: true },
 }, async ({ path }) => {
   try {
-    await post("/api/file", { op: "delete_file", path });
-    logOp("mindos_delete_file", { path }, "ok", `Deleted "${path}"`);
-    return ok(`Deleted "${path}"`);
-  } catch (e) { logOp("mindos_delete_file", { path }, "error", String(e)); return error(String(e)); }
+    const res = await _post("/api/file", { op: "delete_file", path });
+    const trashId = res?.trashId ? ` (trashId: ${res.trashId})` : '';
+    _logOp("mindos_delete_file", { path }, "ok", `Moved to trash: "${path}"${trashId}`);
+    return ok(`Moved to trash: "${path}"${trashId}`);
+  } catch (e) { _logOp("mindos_delete_file", { path }, "error", String(e)); return error(String(e)); }
 });
 
 // ── mindos_rename_file ──────────────────────────────────────────────────────
@@ -310,7 +324,7 @@ server.registerTool("mindos_rename_file", {
   }),
 }, async ({ path, new_name }) => {
   try {
-    const json = await post("/api/file", { op: "rename_file", path, new_name });
+    const json = await _post("/api/file", { op: "rename_file", path, new_name });
     return ok(`Renamed "${path}" → "${json.newPath}"`);
   } catch (e) { return error(String(e)); }
 });
@@ -326,7 +340,7 @@ server.registerTool("mindos_move_file", {
   }),
 }, async ({ from_path, to_path }) => {
   try {
-    const json = await post("/api/file", { op: "move_file", path: from_path, to_path });
+    const json = await _post("/api/file", { op: "move_file", path: from_path, to_path });
     const affected = json.affectedFiles as string[] ?? [];
     const lines = [`Moved "${from_path}" → "${json.newPath}"`];
     if (affected.length > 0) {
@@ -358,10 +372,10 @@ server.registerTool("mindos_search_notes", {
     if (file_type !== "all") params.file_type = file_type;
     if (modified_after) params.modified_after = modified_after;
     if (response_format) params.format = response_format;
-    const json = await get("/api/search", params);
-    logOp("mindos_search_notes", { query, limit }, "ok", `Search completed`);
+    const json = await _get("/api/search", params);
+    _logOp("mindos_search_notes", { query, limit }, "ok", `Search completed`);
     return ok(truncate(JSON.stringify(json, null, 2)));
-  } catch (e) { logOp("mindos_search_notes", { query }, "error", String(e)); return error(String(e)); }
+  } catch (e) { _logOp("mindos_search_notes", { query }, "error", String(e)); return error(String(e)); }
 });
 
 // ── mindos_get_recent ───────────────────────────────────────────────────────
@@ -376,7 +390,7 @@ server.registerTool("mindos_get_recent", {
   annotations: { readOnlyHint: true },
 }, async ({ limit, response_format }) => {
   try {
-    const json = await get("/api/recent-files", { limit: String(limit), format: response_format });
+    const json = await _get("/api/recent-files", { limit: String(limit), format: response_format });
     return ok(JSON.stringify(json, null, 2));
   } catch (e) { return error(String(e)); }
 });
@@ -392,7 +406,7 @@ server.registerTool("mindos_read_lines", {
   annotations: { readOnlyHint: true },
 }, async ({ path }) => {
   try {
-    const json = await get("/api/file", { path, op: "read_lines" });
+    const json = await _get("/api/file", { path, op: "read_lines" });
     const lines = json.lines as string[];
     const numbered = lines.map((l, i) => `${i}: ${l}`).join("\n");
     return ok(`${lines.length} lines total:\n\n${numbered}`);
@@ -411,7 +425,7 @@ server.registerTool("mindos_insert_lines", {
   }),
 }, async ({ path, after_index, lines }) => {
   try {
-    await post("/api/file", { op: "insert_lines", path, after_index, lines });
+    await _post("/api/file", { op: "insert_lines", path, after_index, lines });
     return ok(`Inserted ${lines.length} line(s) after index ${after_index} in "${path}"`);
   } catch (e) { return error(String(e)); }
 });
@@ -429,7 +443,7 @@ server.registerTool("mindos_update_lines", {
   }),
 }, async ({ path, start, end, lines }) => {
   try {
-    await post("/api/file", { op: "update_lines", path, start, end, lines });
+    await _post("/api/file", { op: "update_lines", path, start, end, lines });
     return ok(`Replaced lines ${start}–${end} in "${path}" with ${lines.length} new line(s)`);
   } catch (e) { return error(String(e)); }
 });
@@ -445,10 +459,10 @@ server.registerTool("mindos_append_to_file", {
   }),
 }, async ({ path, content }) => {
   try {
-    await post("/api/file", { op: "append_to_file", path, content });
-    logOp("mindos_append_to_file", { path }, "ok", `Appended ${content.length} chars`);
+    await _post("/api/file", { op: "append_to_file", path, content });
+    _logOp("mindos_append_to_file", { path }, "ok", `Appended ${content.length} chars`);
     return ok(`Appended ${content.length} character(s) to "${path}"`);
-  } catch (e) { logOp("mindos_append_to_file", { path }, "error", String(e)); return error(String(e)); }
+  } catch (e) { _logOp("mindos_append_to_file", { path }, "error", String(e)); return error(String(e)); }
 });
 
 // ── mindos_insert_after_heading ─────────────────────────────────────────────
@@ -463,10 +477,10 @@ server.registerTool("mindos_insert_after_heading", {
   }),
 }, async ({ path, heading, content }) => {
   try {
-    await post("/api/file", { op: "insert_after_heading", path, heading, content });
-    logOp("mindos_insert_after_heading", { path, heading }, "ok", `Inserted after "${heading}"`);
+    await _post("/api/file", { op: "insert_after_heading", path, heading, content });
+    _logOp("mindos_insert_after_heading", { path, heading }, "ok", `Inserted after "${heading}"`);
     return ok(`Inserted content after heading "${heading}" in "${path}"`);
-  } catch (e) { logOp("mindos_insert_after_heading", { path, heading }, "error", String(e)); return error(String(e)); }
+  } catch (e) { _logOp("mindos_insert_after_heading", { path, heading }, "error", String(e)); return error(String(e)); }
 });
 
 // ── mindos_update_section ───────────────────────────────────────────────────
@@ -481,10 +495,10 @@ server.registerTool("mindos_update_section", {
   }),
 }, async ({ path, heading, content }) => {
   try {
-    await post("/api/file", { op: "update_section", path, heading, content });
-    logOp("mindos_update_section", { path, heading }, "ok", `Updated section "${heading}"`);
+    await _post("/api/file", { op: "update_section", path, heading, content });
+    _logOp("mindos_update_section", { path, heading }, "ok", `Updated section "${heading}"`);
     return ok(`Updated section "${heading}" in "${path}"`);
-  } catch (e) { logOp("mindos_update_section", { path, heading }, "error", String(e)); return error(String(e)); }
+  } catch (e) { _logOp("mindos_update_section", { path, heading }, "error", String(e)); return error(String(e)); }
 });
 
 // ── mindos_append_csv ───────────────────────────────────────────────────────
@@ -498,7 +512,7 @@ server.registerTool("mindos_append_csv", {
   }),
 }, async ({ path, row }) => {
   try {
-    const json = await post("/api/file", { op: "append_csv", path, row });
+    const json = await _post("/api/file", { op: "append_csv", path, row });
     return ok(`Appended row to "${path}". File now has ${json.newRowCount} rows.`);
   } catch (e) { return error(String(e)); }
 });
@@ -514,7 +528,7 @@ server.registerTool("mindos_get_backlinks", {
   annotations: { readOnlyHint: true },
 }, async ({ path }) => {
   try {
-    const json = await get("/api/backlinks", { path });
+    const json = await _get("/api/backlinks", { path });
     return ok(JSON.stringify(json, null, 2));
   } catch (e) { return error(String(e)); }
 });
@@ -532,7 +546,7 @@ server.registerTool("mindos_bootstrap", {
   try {
     const params: Record<string, string> = {};
     if (target_dir) params.target_dir = target_dir;
-    const json = await get("/api/bootstrap", params);
+    const json = await _get("/api/bootstrap", params);
     const sections = Object.entries(json)
       .filter(([, v]) => v !== undefined && v !== null)
       .map(([key, val]) => `--- ${key} ---\n\n${val}`)
@@ -553,7 +567,7 @@ server.registerTool("mindos_get_history", {
   annotations: { readOnlyHint: true },
 }, async ({ path, limit }) => {
   try {
-    const json = await get("/api/git", { op: "history", path, limit: String(limit) });
+    const json = await _get("/api/git", { op: "history", path, limit: String(limit) });
     const entries = json.entries as Array<{ hash: string; date: string; message: string; author: string }>;
     if (entries.length === 0) return ok(`No git history found for "${path}"`);
     const lines = [`# Git History: ${path}`, "", `${entries.length} commit(s):`, ""];
@@ -576,7 +590,7 @@ server.registerTool("mindos_get_file_at_version", {
   annotations: { readOnlyHint: true },
 }, async ({ path, commit }) => {
   try {
-    const json = await get("/api/git", { op: "show", path, commit });
+    const json = await _get("/api/git", { op: "show", path, commit });
     const content = json.content as string;
     return ok(truncate(`# ${path} @ ${commit.slice(0, 8)}\n\n${content}`));
   } catch (e) { return error(String(e)); }
@@ -648,7 +662,9 @@ async function main() {
       const sid = transport.sessionId;
       if (sid) {
         sessions.set(sid, { transport, server });
-        console.error(`[MCP] New session ${sid.slice(0, 8)} (${sessions.size} active)`);
+        const client = server.server.getClientVersion();
+        const clientLabel = client?.name ? ` (${client.name})` : '';
+        console.error(`[MCP] New session ${sid.slice(0, 8)}${clientLabel} (${sessions.size} active)`);
       }
     });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geminilight/mindos",
-  "version": "0.6.39",
+  "version": "0.6.40",
   "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/setup.js

@@ -1228,7 +1228,7 @@ async function main() {
   console.log(`\n${c.green(t('cfgSaved'))}: ${c.dim(CONFIG_PATH)}`);
 
   // ── Skill rules are now built into SKILL.md — no install needed ──────────
-  // user-skill-rules.md will be created on first preference capture or via `mindos init-skills`.
+  // .mindos/user-preferences.md will be created on first preference capture or via `mindos init-skills`.
 
   // ── Step 7: MCP Agent Install ──────────────────────────────────────────────
   write('\n');

package/skills/mindos/SKILL.md

@@ -21,7 +21,7 @@ description: >
 
 1. The **bootstrap directory tree is the primary index** — reason from names and hierarchy before calling search. Most questions can be answered by reading what's already in context.
 2. **Default to read-only.** Only invoke write tools when the user explicitly asks to save, record, organize, or edit. Lookup / summarize / quote = no writes.
-3. **Rule precedence** (highest wins): user's current-turn instruction → `user-skill-rules.md` → nearest directory `INSTRUCTION.md` → root `INSTRUCTION.md` → this SKILL's defaults.
+3. **Rule precedence** (highest wins): user's current-turn instruction → `.mindos/user-preferences.md` → nearest directory `INSTRUCTION.md` → root `INSTRUCTION.md` → this SKILL's defaults.
 4. **Multi-file edits require a plan first.** Present the full change list; execute only after approval.
 5. After create/delete/move/rename → **sync affected READMEs** automatically.
 
@@ -141,7 +141,7 @@ For write, SOP, structural, and handoff patterns → see Write & Workflow Supple
 
 ## Post-task hooks
 
-After **write tasks** (not simple single-file edits or read-only), scan this table. If a condition matches, make a one-line proposal. At most 1 proposal; pick highest priority. Check `user-skill-rules.md` suppression section first. Skip all if user asked for quiet mode.
+After **write tasks** (not simple single-file edits or read-only), scan this table. If a condition matches, make a one-line proposal. At most 1 proposal; pick highest priority. Check `.mindos/user-preferences.md` suppression section first. Skip all if user asked for quiet mode.
 
 | Hook | Priority | Condition |
 |------|----------|-----------|
@@ -157,7 +157,7 @@ If a hook triggers → read [references/post-task-hooks.md](./references/post-ta
 
 ## Preference capture
 
-When the user expresses a standing preference ("don't do X", "always put Y in Z"), read [references/preference-capture.md](./references/preference-capture.md) and follow the confirm-then-write flow to `user-skill-rules.md`.
+When the user expresses a standing preference ("don't do X", "always put Y in Z"), read [references/preference-capture.md](./references/preference-capture.md) and follow the confirm-then-write flow to `.mindos/user-preferences.md`.
 **Do NOT read** preference-capture unless the user actually expressed a preference to persist.
 
 ## SOP authoring

package/skills/mindos/references/preference-capture.md

@@ -1,4 +1,4 @@
-# Preference capture (`user-skill-rules.md`)
+# Preference capture (`user-preferences.md`)
 
 ## When to capture
 
@@ -7,14 +7,14 @@ The user expresses a preference correction (e.g. "don't do X", "next time rememb
 ## Confirm-then-write flow
 
 1. **First occurrence of a new preference**: propose the rule and target file before writing.
-   - "Record this preference to `user-skill-rules.md`? Rule: _{summary}_"
+   - "Record this preference to `user-preferences.md`? Rule: _{summary}_"
    - Write only after user confirms.
-2. **Repeated confirmation on similar category**: after the user confirms the same category of preference 3+ times, auto-write future rules in that category without asking. Add an `auto-confirm: true` flag to the category header in `user-skill-rules.md`.
+2. **Repeated confirmation on similar category**: after the user confirms the same category of preference 3+ times, auto-write future rules in that category without asking. Add an `auto-confirm: true` flag to the category header in `user-preferences.md`.
 3. **User explicitly grants blanket permission** (e.g. "just record preferences directly"): set a top-level `auto-confirm-all: true` flag and skip confirmation for all future captures.
 
 ## File location
 
-- Target: `user-skill-rules.md` in the knowledge base root (read by `mindos_bootstrap` when present).
+- Target: `.mindos/user-preferences.md` in the knowledge base (read by `mindos_bootstrap` when present).
 - If the file does not exist, create it with the template below on first confirmed write.
 
 ## File template

package/skills/mindos/references/write-supplement.md

@@ -94,7 +94,7 @@ Read the handoff document or last agent's progress notes → identify: current s
 
 ## Post-task hooks
 
-After **write tasks** (not simple single-file edits or read-only), scan this table. If a condition matches, make a one-line proposal. At most 1 proposal; pick highest priority. Check `user-skill-rules.md` suppression section first. Skip all if user asked for quiet mode.
+After **write tasks** (not simple single-file edits or read-only), scan this table. If a condition matches, make a one-line proposal. At most 1 proposal; pick highest priority. Check `.mindos/user-preferences.md` suppression section first. Skip all if user asked for quiet mode.
 
 | Hook | Priority | Condition |
 |------|----------|-----------|
@@ -110,7 +110,7 @@ If a hook triggers → read [references/post-task-hooks.md](./references/post-ta
 
 ## Preference capture
 
-When the user expresses a standing preference ("don't do X", "always put Y in Z"), read [references/preference-capture.md](./references/preference-capture.md) and follow the confirm-then-write flow to `user-skill-rules.md`.
+When the user expresses a standing preference ("don't do X", "always put Y in Z"), read [references/preference-capture.md](./references/preference-capture.md) and follow the confirm-then-write flow to `.mindos/user-preferences.md`.
 **Do NOT read** preference-capture unless the user actually expressed a preference to persist.
 
 ## SOP authoring

package/skills/mindos-zh/SKILL.md

@@ -20,7 +20,7 @@ description: >
 
 1. **bootstrap 目录树是首要索引** — 先从目录名和层级推断，再搜索。大多数定位不需要工具调用。
 2. **默认只读。** 只有用户明确要求保存、记录、整理、修改时才调写入工具。查阅/总结/引用 = 不写。
-3. **规则优先级**（越上越优先）：用户当轮指令 → `user-skill-rules.md` → 就近目录 `INSTRUCTION.md` → 根 `INSTRUCTION.md` → 本 SKILL 默认。
+3. **规则优先级**（越上越优先）：用户当轮指令 → `.mindos/user-preferences.md` → 就近目录 `INSTRUCTION.md` → 根 `INSTRUCTION.md` → 本 SKILL 默认。
 4. **多文件编辑必须先出计划。** 展示完整变更清单，确认后再执行。
 5. 增删/移动/重命名后 → **自动同步受影响 README**。
 
@@ -140,7 +140,7 @@ description: >
 
 ## 任务后 Hooks
 
-**写入任务**完成后（简单单文件修改或只读查阅跳过），扫描下表。命中则发起一句话提议，最多 1 条，选优先级最高项。先查 `user-skill-rules.md` 的抑制区；用户要求安静模式时全部跳过。
+**写入任务**完成后（简单单文件修改或只读查阅跳过），扫描下表。命中则发起一句话提议，最多 1 条，选优先级最高项。先查 `.mindos/user-preferences.md` 的抑制区；用户要求安静模式时全部跳过。
 
 | Hook | 优先级 | 触发条件 |
 |------|--------|---------|
@@ -156,7 +156,7 @@ description: >
 
 ## 偏好捕获
 
-用户表达要长期记住的偏好（「以后不要…」「这个该放在…」）时，读 [references/preference-capture.md](./references/preference-capture.md) 并按确认后写入流程存入 `user-skill-rules.md`。
+用户表达要长期记住的偏好（「以后不要…」「这个该放在…」）时，读 [references/preference-capture.md](./references/preference-capture.md) 并按确认后写入流程存入 `.mindos/user-preferences.md`。
 **不要读** preference-capture 除非用户真的表达了要持久化的偏好。
 
 ## SOP 编写

package/skills/mindos-zh/references/preference-capture.md

@@ -1,4 +1,4 @@
-# 偏好捕获（`user-skill-rules.md`）
+# 偏好捕获（`user-preferences.md`）
 
 ## 何时捕获
 
@@ -7,14 +7,14 @@
 ## 确认后写入流程
 
 1. **某类偏好首次出现**：先提议，用户确认后再写入。
-   - 「记录此偏好到 `user-skill-rules.md`？规则：_{摘要}_」
+   - 「记录此偏好到 `user-preferences.md`？规则：_{摘要}_」
    - 仅在用户确认后写入。
-2. **同类偏好确认 3 次以上**：该类别在 `user-skill-rules.md` 中标记 `auto-confirm: true`，后续同类偏好自动写入，不再询问。
+2. **同类偏好确认 3 次以上**：该类别在 `user-preferences.md` 中标记 `auto-confirm: true`，后续同类偏好自动写入，不再询问。
 3. **用户明确授权**（如「偏好直接记就行」）：设置顶层 `auto-confirm-all: true`，之后所有偏好跳过确认直接写入。
 
 ## 文件位置
 
-- 目标：知识库根目录的 `user-skill-rules.md`（存在时由 `mindos_bootstrap` 读取）。
+- 目标：知识库 `.mindos/user-preferences.md`（存在时由 `mindos_bootstrap` 读取）。
 - 若文件不存在，在首次确认写入时按下方模板创建。
 
 ## 文件模板

package/skills/mindos-zh/references/write-supplement.md

@@ -94,7 +94,7 @@
 
 ## 任务后 Hooks
 
-**写入任务**完成后（简单单文件修改或只读查阅跳过），扫描下表。命中则发起一句话提议，最多 1 条，选优先级最高项。先查 `user-skill-rules.md` 的抑制区；用户要求安静模式时全部跳过。
+**写入任务**完成后（简单单文件修改或只读查阅跳过），扫描下表。命中则发起一句话提议，最多 1 条，选优先级最高项。先查 `.mindos/user-preferences.md` 的抑制区；用户要求安静模式时全部跳过。
 
 | Hook | 优先级 | 触发条件 |
 |------|--------|---------|
@@ -110,7 +110,7 @@
 
 ## 偏好捕获
 
-用户表达要长期记住的偏好（「以后不要…」「这个该放在…」）时，读 [references/preference-capture.md](./references/preference-capture.md) 并按确认后写入流程存入 `user-skill-rules.md`。
+用户表达要长期记住的偏好（「以后不要…」「这个该放在…」）时，读 [references/preference-capture.md](./references/preference-capture.md) 并按确认后写入流程存入 `.mindos/user-preferences.md`。
 **不要读** preference-capture 除非用户真的表达了要持久化的偏好。
 
 ## SOP 编写

package/templates/empty/INSTRUCTION.md

@@ -174,4 +174,3 @@ Create it only when local rules are reusable and meaningful. Avoid creating them
 
 - `CONFIG.json` is the single source of truth for all configuration.
 - Field semantics are embedded in `keySpecs`; directory naming rules in `naming`.
-- No separate `CONFIG.md` is needed.

package/templates/en/INSTRUCTION.md

@@ -174,4 +174,3 @@ Create it only when local rules are reusable and meaningful. Avoid creating them
 
 - `CONFIG.json` is the single source of truth for all configuration.
 - Field semantics are embedded in `keySpecs`; directory naming rules in `naming`.
-- No separate `CONFIG.md` is needed.

package/templates/template-generation-skill.md

@@ -55,7 +55,6 @@
 
 - `CONFIG.json` 是配置的唯一权威源。
 - 字段语义内嵌于 `keySpecs`；目录命名规则内嵌于 `naming`。
-- 无需额外的 `CONFIG.md`。
 
 ## 7. 配置设计约束
 

package/templates/zh/INSTRUCTION.md

@@ -174,4 +174,3 @@ Agent 进入知识库时，按以下顺序加载上下文：
 
 - `CONFIG.json` 是配置的唯一权威源。
 - 字段语义内嵌于 `keySpecs`；目录命名规则内嵌于 `naming`。
-- 无需额外的 `CONFIG.md`。