@danielmarbach/mnemonic-mcp 0.23.0 → 0.24.0

package/build/markdown-ast.d.ts

@@ -0,0 +1,4 @@
+import type { Root } from "mdast";
+export declare function parseBody(content: string): Root;
+export declare function serializeBody(tree: Root): string;
+//# sourceMappingURL=markdown-ast.d.ts.map

package/build/markdown-ast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-ast.d.ts","sourceRoot":"","sources":["../src/markdown-ast.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;AAElC,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE/C;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAEhD"}

package/build/markdown-ast.js

@@ -0,0 +1,10 @@
+import { unified } from "unified";
+import remarkParse from "remark-parse";
+import remarkStringify from "remark-stringify";
+export function parseBody(content) {
+    return unified().use(remarkParse).parse(content);
+}
+export function serializeBody(tree) {
+    return unified().use(remarkStringify, { bullet: "-" }).stringify(tree);
+}
+//# sourceMappingURL=markdown-ast.js.map

package/build/markdown-ast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-ast.js","sourceRoot":"","sources":["../src/markdown-ast.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,WAAW,MAAM,cAAc,CAAC;AACvC,OAAO,eAAe,MAAM,kBAAkB,CAAC;AAG/C,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,OAAO,OAAO,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,OAAO,CAAS,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAU;IACtC,OAAO,OAAO,EAAE,CAAC,GAAG,CAAC,eAAe,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,SAAS,CAAC,IAAI,CAAW,CAAC;AACnF,CAAC"}

package/build/semantic-patch.d.ts

@@ -0,0 +1,36 @@
+export type SemanticSelector = {
+    heading: string;
+} | {
+    headingStartsWith: string;
+} | {
+    nthChild: number;
+} | {
+    lastChild: true;
+};
+export type SemanticOperation = {
+    op: "appendChild";
+    value: string;
+} | {
+    op: "prependChild";
+    value: string;
+} | {
+    op: "replace";
+    value: string;
+} | {
+    op: "replaceChildren";
+    value: string;
+} | {
+    op: "insertAfter";
+    value: string;
+} | {
+    op: "insertBefore";
+    value: string;
+} | {
+    op: "remove";
+};
+export interface SemanticPatch {
+    selector: SemanticSelector;
+    operation: SemanticOperation;
+}
+export declare function applySemanticPatches(body: string, patches: SemanticPatch[]): Promise<string>;
+//# sourceMappingURL=semantic-patch.d.ts.map

package/build/semantic-patch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-patch.d.ts","sourceRoot":"","sources":["../src/semantic-patch.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,gBAAgB,GACxB;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GACnB;IAAE,iBAAiB,EAAE,MAAM,CAAA;CAAE,GAC7B;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GACpB;IAAE,SAAS,EAAE,IAAI,CAAA;CAAE,CAAC;AAExB,MAAM,MAAM,iBAAiB,GACzB;IAAE,EAAE,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,EAAE,EAAE,cAAc,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,EAAE,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,EAAE,EAAE,iBAAiB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,EAAE,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,EAAE,EAAE,cAAc,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,EAAE,EAAE,QAAQ,CAAA;CAAE,CAAC;AAErB,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,SAAS,EAAE,iBAAiB,CAAC;CAC9B;AA6ED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA4ElG"}

package/build/semantic-patch.js

@@ -0,0 +1,141 @@
+import { parseBody, serializeBody } from "./markdown-ast.js";
+import { cleanMarkdown } from "./markdown.js";
+function getHeadingText(node) {
+    return node.children
+        .filter((c) => c.type === "text")
+        .map((c) => c.value)
+        .join("");
+}
+function isHeadingNode(node) {
+    return node.type === "heading";
+}
+function resolveSelector(tree, selector) {
+    if ("heading" in selector) {
+        for (let i = 0; i < tree.children.length; i++) {
+            const child = tree.children[i];
+            if (isHeadingNode(child) && getHeadingText(child) === selector.heading) {
+                return { parent: tree, index: i, target: child };
+            }
+        }
+        return undefined;
+    }
+    if ("headingStartsWith" in selector) {
+        for (let i = 0; i < tree.children.length; i++) {
+            const child = tree.children[i];
+            if (isHeadingNode(child) && getHeadingText(child).startsWith(selector.headingStartsWith)) {
+                return { parent: tree, index: i, target: child };
+            }
+        }
+        return undefined;
+    }
+    if ("nthChild" in selector) {
+        const index = selector.nthChild;
+        if (index < 0 || index >= tree.children.length) {
+            return undefined;
+        }
+        return { parent: tree, index, target: tree.children[index] };
+    }
+    if ("lastChild" in selector) {
+        if (tree.children.length === 0) {
+            return undefined;
+        }
+        const index = tree.children.length - 1;
+        return { parent: tree, index, target: tree.children[index] };
+    }
+    return undefined;
+}
+const CONTAINER_TYPES = new Set(["heading", "blockquote", "list", "paragraph"]);
+function getTargetChildren(target) {
+    if (CONTAINER_TYPES.has(target.type)) {
+        return target.children;
+    }
+    return undefined;
+}
+function parseValueNodes(value) {
+    const fragment = parseBody(value);
+    return fragment.children;
+}
+function collectAvailableHeadings(tree) {
+    const headings = [];
+    for (const child of tree.children) {
+        if (isHeadingNode(child)) {
+            headings.push(getHeadingText(child));
+        }
+    }
+    return headings;
+}
+export async function applySemanticPatches(body, patches) {
+    const tree = parseBody(body);
+    for (const patch of patches) {
+        const resolved = resolveSelector(tree, patch.selector);
+        if (!resolved) {
+            const headings = collectAvailableHeadings(tree);
+            let diagnostic = `Selector not found: ${JSON.stringify(patch.selector)}`;
+            if (headings.length > 0) {
+                diagnostic += `\nAvailable headings:\n${headings.map((h) => `  - ${h}`).join("\n")}`;
+            }
+            else {
+                diagnostic += "\nNo headings in document.";
+            }
+            throw new Error(diagnostic);
+        }
+        const { parent, index, target } = resolved;
+        const op = patch.operation;
+        switch (op.op) {
+            case "appendChild": {
+                const targetChildren = getTargetChildren(target);
+                if (!targetChildren) {
+                    throw new Error(`Cannot appendChild to node of type '${target.type}'`);
+                }
+                const newNodes = parseValueNodes(op.value);
+                targetChildren.push(...newNodes);
+                break;
+            }
+            case "prependChild": {
+                const targetChildren = getTargetChildren(target);
+                if (!targetChildren) {
+                    throw new Error(`Cannot prependChild to node of type '${target.type}'`);
+                }
+                const newNodes = parseValueNodes(op.value);
+                targetChildren.unshift(...newNodes);
+                break;
+            }
+            case "replace": {
+                const newNodes = parseValueNodes(op.value);
+                parent.children.splice(index, 1, ...newNodes);
+                break;
+            }
+            case "replaceChildren": {
+                const targetChildren = getTargetChildren(target);
+                if (!targetChildren) {
+                    throw new Error(`Cannot replaceChildren of node of type '${target.type}'`);
+                }
+                const newNodes = parseValueNodes(op.value);
+                targetChildren.length = 0;
+                targetChildren.push(...newNodes);
+                break;
+            }
+            case "insertAfter": {
+                const newNodes = parseValueNodes(op.value);
+                parent.children.splice(index + 1, 0, ...newNodes);
+                break;
+            }
+            case "insertBefore": {
+                const newNodes = parseValueNodes(op.value);
+                parent.children.splice(index, 0, ...newNodes);
+                break;
+            }
+            case "remove": {
+                parent.children.splice(index, 1);
+                break;
+            }
+            default: {
+                const _exhaustive = op;
+                throw new Error(`Unknown operation: ${_exhaustive}`);
+            }
+        }
+    }
+    const serialized = serializeBody(tree);
+    return cleanMarkdown(serialized);
+}
+//# sourceMappingURL=semantic-patch.js.map

package/build/semantic-patch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-patch.js","sourceRoot":"","sources":["../src/semantic-patch.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danielmarbach/mnemonic-mcp",
-  "version": "0.23.0",
+  "version": "0.24.0",
   "description": "A local MCP memory server backed by markdown + JSON files, synced via git",
   "type": "module",
   "repository": {
@@ -35,7 +35,10 @@
     "@modelcontextprotocol/sdk": "^1.10.1",
     "gray-matter": "^4.0.3",
     "markdownlint": "^0.40.0",
+    "remark-parse": "^11.0.0",
+    "remark-stringify": "^11.0.0",
     "simple-git": "^3.27.0",
+    "unified": "^11.0.0",
     "zod": "^4.3.6"
   },
   "devDependencies": {