@sksoftofficial/mindroot 1.0.4 → 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.4",
+  "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/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"));
+});