@sksoftofficial/mindroot 1.0.3 → 1.0.5

package/README.md

@@ -143,7 +143,7 @@ All tools are prefixed `mindroot_`.
 | `list_notes` | `project*` | List notes with section paths |
 | `read_note` | `project*`, `path`, `section?` | Full note content, or one section's body via `section` (hash-verified, auto-reindexed) |
 | `save_note` | `project*`, `path`, `content` | Create/overwrite a note |
-| `update_section` | `project*`, `path`, `heading_path`, `content` | Replace one section body, leave the rest untouched |
+| `update_section` | `project*`, `path`, `heading_path`, `content` | Replace one section body, or append the section when missing |
 | `delete_note` | `project*`, `path` | Delete a note (clears its linked memories) |
 
 ## REST API

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sksoftofficial/mindroot",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "Long-term memory for AI agents: hybrid-searched memories over human-editable markdown notes. 100% local — offline ONNX embeddings, SQLite FTS5, MCP server, REST API, CLI, dashboard. No cloud, no API keys.",
   "homepage": "https://skbilisim.com/en/projects/mindroot",
   "type": "module",

package/src/core.js

@@ -10,7 +10,7 @@ import {
   reindexDoc,
   httpError,
 } from "./indexer.js";
-import { parseMarkdown, replaceSectionBody } from "./markdown.js";
+import { appendSection, parseMarkdown, replaceSectionBody } from "./markdown.js";
 import { embedDoc } from "./embedder.js";
 import { ONNX_MODEL_ID } from "./paths.js";
 import { searchMemories as hybridSearchMemories, searchNotes as hybridSearchNotes, searchProjects } from "./search.js";
@@ -137,8 +137,9 @@ export async function updateSection(db, slug, relPath, headingPath, newContent)
   const { content } = await verifyAndLoadDoc(db, slug, relPath);
   const parsed = parseMarkdown(content);
   const sec = parsed.sections.find((s) => s.path === headingPath);
-  if (!sec) throw httpError(404, `section not found: ${headingPath}`);
-  const updated = replaceSectionBody(content, sec, newContent);
+  const updated = sec
+    ? replaceSectionBody(content, sec, newContent)
+    : appendSection(content, headingPath, newContent);
   return saveNote(db, slug, relPath, updated);
 }
 

package/src/dashboard/index.html

@@ -44,7 +44,16 @@
   #gate { margin:auto; text-align:center; display:flex; flex-direction:column; gap:14px; width:min(420px, calc(100% - 32px)); padding:28px; background:var(--bg2); border:1px solid var(--border); border-radius:10px; box-shadow:0 12px 40px rgba(0,0,0,.28) }
   #gate input { width:100% }
   main { display:flex; flex:1; overflow:hidden }
-  aside { position:relative; z-index:1; width:230px; background:var(--bg2); border-right:1px solid var(--border-soft); overflow-y:auto; padding:10px 8px; box-shadow:8px 0 20px rgba(0,0,0,.12) }
+  aside { position:relative; z-index:1; width:230px; background:var(--bg2); border-right:1px solid var(--border-soft); overflow-y:auto; padding:10px 14px; box-shadow:8px 0 20px rgba(0,0,0,.12); display:flex; flex-direction:column; gap:8px; transition:width 160ms ease-out }
+  .sidebar-toggle { flex:none; height:34px; padding:0; display:flex; align-items:center; justify-content:center }
+  .sidebar-toggle svg { width:17px; height:17px; stroke:currentColor; transition:transform 160ms ease-out }
+  @media (min-width:701px) {
+    aside.collapsed { width:56px; padding:10px 12px }
+    aside.collapsed .sidebar-toggle svg { transform:rotate(180deg) }
+    aside.collapsed .proj { padding:7px 0; text-align:center; font-size:0 }
+    aside.collapsed .proj::before { content:attr(data-initial); font-size:12px; line-height:inherit }
+  }
+  #projList { display:flex; flex-direction:column; gap:2px }
   .proj { padding:7px 10px; border-radius:5px; cursor:pointer; color:var(--dim) }
   .proj:hover { background:var(--hover); color:var(--fg) }
   .proj.active { background:var(--accent-soft); color:#f2b46f }
@@ -89,7 +98,7 @@
   .editor-document { min-width:0 }
   .editor-title { max-width:320px; color:var(--fg); font-size:13px; font-weight:600; overflow:hidden; text-overflow:ellipsis; white-space:nowrap }
   .editor-actions { justify-self:end }
-  .viewmode { display:inline-flex; gap:0; padding:2px; background:#191919; border:1px solid var(--border); border-radius:6px }
+  .viewmode { display:inline-flex; gap:2px; padding:2px; background:#191919; border:1px solid var(--border); border-radius:6px }
   .viewmode button { padding:4px 10px; background:transparent; border-color:transparent }
   .viewmode button:hover { background:var(--hover); border-color:transparent }
   .viewmode button.on { background:var(--accent-soft); color:#f2b46f; border-color:transparent }
@@ -141,12 +150,13 @@
     .header-lock-label { display:none }
     main { flex-direction:column }
     aside { width:100%; max-height:112px; border-right:0; border-bottom:1px solid var(--border-soft); padding:7px 8px; box-shadow:0 8px 20px rgba(0,0,0,.12) }
-    #projList { display:flex; gap:4px; overflow-x:auto }
+    #projList { flex-direction:row; gap:4px; overflow-x:auto }
     .proj { flex:none; white-space:nowrap }
     #content { padding:14px }
     .workspace-head { align-items:flex-start; flex-wrap:wrap; gap:8px; margin-bottom:12px; padding-bottom:10px }
     button, input { min-height:44px; touch-action:manipulation }
     .header-lock, .back-button { width:44px; height:44px }
+    .sidebar-toggle { display:none }
     .proj, .tab { min-height:44px; display:flex; align-items:center }
     .tab { padding:5px 8px }
     .delete-project { padding:5px 9px }
@@ -202,7 +212,14 @@
 </div>
 
 <main id="app" style="display:none">
-  <aside><div id="projList"></div></aside>
+  <aside>
+    <button class="sidebar-toggle" type="button" title="Shrink menu" aria-label="Shrink menu" aria-expanded="true" onclick="toggleSidebar()">
+      <svg viewBox="0 0 24 24" fill="none" aria-hidden="true">
+        <path d="m14 7-5 5 5 5" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
+      </svg>
+    </button>
+    <div id="projList"></div>
+  </aside>
   <section id="content"></section>
 </main>
 
@@ -300,6 +317,7 @@ async function renderProjects() {
   for (const r of rows) {
     const div = document.createElement("div");
     div.className = "proj" + (r.slug === currentProject ? " active" : "");
+    div.dataset.initial = r.slug.slice(0, 2).toUpperCase();
     div.textContent = r.slug;
     div.title = r.docs + " notes, " + r.memories + " memories";
     div.onclick = () => selectProject(r.slug);
@@ -382,6 +400,24 @@ async function renderNotes(view) {
 
 let mdMode = localStorage.getItem("mindroot_mdmode") || "preview";
 
+let sidebarCollapsed = localStorage.getItem("mindroot_sidebar") === "collapsed";
+function toggleSidebar() { setSidebar(!sidebarCollapsed); }
+function setSidebar(collapsed) {
+  sidebarCollapsed = collapsed;
+  localStorage.setItem("mindroot_sidebar", collapsed ? "collapsed" : "expanded");
+  applySidebar();
+}
+function applySidebar() {
+  const aside = document.querySelector("main aside");
+  const btn = $(".sidebar-toggle");
+  aside.classList.toggle("collapsed", sidebarCollapsed);
+  btn.setAttribute("aria-expanded", String(!sidebarCollapsed));
+  const label = sidebarCollapsed ? "Expand menu" : "Shrink menu";
+  btn.title = label;
+  btn.setAttribute("aria-label", label);
+}
+applySidebar();
+
 function renderMd(text) {
   if (window.marked && window.DOMPurify) {
     marked.setOptions({ gfm: true, breaks: true });

package/src/markdown.js

@@ -70,3 +70,9 @@ export function replaceSectionBody(raw, sec, newBody) {
   const replacement = newBody.replace(/\n+$/, "").split("\n");
   return [...lines.slice(0, sec.bodyStart), ...replacement, ...lines.slice(sec.bodyEnd)].join("\n");
 }
+
+export function appendSection(raw, headingPath, body) {
+  const note = raw.replace(/\n+$/, "");
+  const content = body.replace(/\n+$/, "");
+  return `${note ? `${note}\n\n` : ""}## ${headingPath}${content ? `\n\n${content}` : ""}\n`;
+}

package/src/mcp.js

@@ -123,7 +123,7 @@ export function tools() {
     {
       name: "mindroot_update_section",
       description:
-        "Replace the body of one heading-section inside an existing note, leaving the rest of the file untouched.",
+        "Replace the body of an existing heading-section, or append it to the note when missing.",
       inputSchema: {
         type: "object",
         properties: {

package/test/markdown.test.js

@@ -1,6 +1,6 @@
 import { test } from "node:test";
 import assert from "node:assert/strict";
-import { parseMarkdown, docTitle, replaceSectionBody } from "../src/markdown.js";
+import { appendSection, parseMarkdown, docTitle, replaceSectionBody } from "../src/markdown.js";
 
 test("parseMarkdown builds nested heading paths and excludes H1", () => {
   const md = "# Title\n\nintro\n\n## Arch\n\ntop\n\n### Arch::Storage\n\nnested\n";
@@ -30,3 +30,8 @@ test("replaceSectionBody splices only the target section", () => {
   assert.match(out, /keep me/);
   assert.match(out, /^# T/);
 });
+
+test("appendSection adds a missing section at the end", () => {
+  const md = "# T\n\n## Existing\n\nkeep me\n";
+  assert.equal(appendSection(md, "Added", "new body"), `${md}\n## Added\n\nnew body\n`);
+});

package/test/mcp.test.js

@@ -109,3 +109,23 @@ test("rename_project moves slug, dir, and embeddings", async () => {
   assert.equal(bad.body.result.isError, true);
   assert.match(bad.body.result.content[0].text, /invalid project slug/);
 });
+
+test("update_section appends a missing section", async () => {
+  await call("mindroot_save_note", {
+    project: "section-upsert",
+    path: "note.md",
+    content: "# Note\n\n## Existing\n\nkeep me\n",
+  });
+
+  const res = await call("mindroot_update_section", {
+    project: "section-upsert",
+    path: "note.md",
+    heading_path: "Added",
+    content: "new body",
+  });
+  assert.equal(res.body.result.isError, undefined);
+
+  const note = JSON.parse(res.body.result.content[0].text);
+  assert.equal(note.content, "# Note\n\n## Existing\n\nkeep me\n\n## Added\n\nnew body\n");
+  assert.ok(note.sections.some((section) => section.path === "Added"));
+});