@danielmarbach/mnemonic-mcp 0.27.1 → 0.28.0

package/build/tools/update.js

@@ -0,0 +1,365 @@
+import { z } from "zod";
+import { ensureBranchSynced, resolveProject, noteProjectRef, projectParam, } from "../helpers/project.js";
+import { formatCommitBody, shouldBlockProtectedBranchCommit, } from "../helpers/git-commit.js";
+import { buildPersistenceStatus, buildMutationRetryContract, formatPersistenceSummary, pushAfterMutation, } from "../helpers/persistence.js";
+import { embedTextForNote } from "../helpers/embed.js";
+import { memoryId, isoDateString } from "../brands.js";
+import { cleanMarkdown, MarkdownLintError } from "../markdown.js";
+import { getErrorMessage } from "../error-utils.js";
+import { embed, embedModel } from "../embeddings.js";
+import { applySemanticPatches } from "../semantic-patch.js";
+import { hasActualChanges, computeFieldsModified } from "../update-detect-changes.js";
+import { suggestAutoRelationships } from "../auto-relate.js";
+import { invalidateActiveProjectCache, getRecentSessionNoteAccesses, getSessionCachedNote, getRecentSessionAccessNote, } from "../cache.js";
+import { NOTE_LIFECYCLES, NOTE_ROLES } from "../storage.js";
+import { UpdateResultSchema, NoteIdSchema, } from "../structured-content.js";
+export function registerUpdateTool(server, ctx) {
+    server.registerTool("update", {
+        title: "Update Memory",
+        description: "Use after `recall` + `get` when an existing memory should be refined instead of creating a duplicate.\n\n" +
+            "Modify an existing memory by id.\n\n" +
+            "Use this when:\n" +
+            "- A stored memory is stale, incomplete, or wrong\n" +
+            "- You recalled something useful and want to refine the same note instead of creating a duplicate\n\n" +
+            "Do not use this when:\n" +
+            "- No note exists yet; use `remember`\n" +
+            "- Several notes need to be merged or retired together; use `consolidate`\n\n" +
+            "Returns:\n" +
+            "- The updated memory id, changed fields, and persistence status\n\n" +
+            "Side effects: rewrites the note, refreshes embeddings, git commits, and may push.\n\n" +
+            "Typical next step:\n" +
+            "- Use `relate` or `consolidate` if the update changes how this note connects to others.\n\n" +
+            "Use `semanticPatch` for targeted edits (more token-efficient). Use `content` only for complete rewrites.",
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+        inputSchema: z.object({
+            id: NoteIdSchema.describe("Exact memory id. Use an id returned by `recall`, `list`, `recent_memories`, or `where_is`."),
+            semanticPatch: z
+                .preprocess((val) => {
+                if (typeof val === "string") {
+                    try {
+                        return JSON.parse(val);
+                    }
+                    catch {
+                        return val;
+                    }
+                }
+                return val;
+            }, z.array(z.object({
+                selector: z.object({
+                    heading: z.string().optional(),
+                    headingStartsWith: z.string().optional(),
+                    nthChild: z.number().int().optional(),
+                    lastChild: z.literal(true).optional(),
+                }).refine((sel) => {
+                    const keys = [sel.heading, sel.headingStartsWith, sel.nthChild, sel.lastChild].filter((v) => v !== undefined);
+                    return keys.length === 1;
+                }, { message: "Selector must have exactly one of: heading, headingStartsWith, nthChild, lastChild" }),
+                operation: z.discriminatedUnion("op", [
+                    z.object({ op: z.literal("appendChild"), value: z.string() }),
+                    z.object({ op: z.literal("prependChild"), value: z.string() }),
+                    z.object({ op: z.literal("replace"), value: z.string() }),
+                    z.object({ op: z.literal("replaceChildren"), value: z.string() }),
+                    z.object({ op: z.literal("insertAfter"), value: z.string() }),
+                    z.object({ op: z.literal("insertBefore"), value: z.string() }),
+                    z.object({ op: z.literal("remove") }),
+                ]),
+            })))
+                .optional()
+                .describe("Targeted edits to note sections. Array of {selector, operation} objects. Mutually exclusive with content. " +
+                "If this fails, fix the issue in your patch values and retry — do NOT fall back to full content rewrite.\n\n" +
+                "selector: exactly one of { heading: \"exact heading text\" } | { headingStartsWith: \"prefix\" } | { lastChild: true } | { nthChild: 0-based-index }\n" +
+                "operation: { op: \"appendChild\", value: \"content\" } | { op: \"prependChild\", value: \"content\" } | { op: \"replace\", value: \"new content\" } | { op: \"replaceChildren\", value: \"new children\" } | { op: \"insertAfter\", value: \"content\" } | { op: \"insertBefore\", value: \"content\" } | { op: \"remove\" }\n\n" +
+                "Example — add a paragraph under ## Findings, replace body under ## Recommendation, remove ## Old Section:\n" +
+                "[\n" +
+                "  { \"selector\": { \"heading\": \"Findings\" }, \"operation\": { \"op\": \"insertAfter\", \"value\": \"A new paragraph.\" } },\n" +
+                "  { \"selector\": { \"heading\": \"Recommendation\" }, \"operation\": { \"op\": \"replace\", \"value\": \"## Recommendation\\n\\nUpdated recommendation.\" } },\n" +
+                "  { \"selector\": { \"heading\": \"Old Section\" }, \"operation\": { \"op\": \"remove\" } }\n" +
+                "]\n\n" +
+                "IMPORTANT: `appendChild`, `prependChild`, and `replaceChildren` do NOT work with `heading` selectors (headings only contain inline text, not block content). To add or replace content under a heading, use `insertAfter`. To replace a heading entirely, use `replace`."),
+            content: z.string().max(100000, "Content must be at most 100,000 characters").optional().describe("Full note body replacement. Use only for complete rewrites or when the note is small. Mutually exclusive with semanticPatch. Content must pass markdown lint. Auto-fixable issues are fixed automatically. Common unfixable issues: fenced code blocks need a language tag (e.g. use ```text not bare ```), and broken links are rejected. If lint fails, fix the specific issues and retry — do NOT fall back to semanticPatch for this."),
+            title: z.string().max(500, "Title must be at most 500 characters").optional().describe("Specific, retrieval-friendly title. Prefer the concrete topic or decision, not a vague label."),
+            tags: z.array(z.string()).optional().describe("Optional tags for later filtering. Use a small number of stable, meaningful tags."),
+            lifecycle: z
+                .enum(NOTE_LIFECYCLES)
+                .optional()
+                .describe("Change lifecycle. Preserve the existing value unless you're intentionally switching it."),
+            role: z
+                .enum(NOTE_ROLES)
+                .optional()
+                .describe("Change role. Preserve the existing value unless you're intentionally switching it."),
+            summary: z.string().optional().describe("Git commit summary only. Imperative mood, concise, and focused on why the change matters."),
+            alwaysLoad: z
+                .boolean()
+                .optional()
+                .describe("When true, this note loads automatically at session start and receives priority in recall and relationship expansion. " +
+                "Use for session anchors and critical context that should always be available."),
+            cwd: projectParam,
+            allowProtectedBranch: z
+                .boolean()
+                .optional()
+                .describe("One-time override for protected branch checks. " +
+                "When true, update can commit on a protected branch without changing project policy."),
+        }),
+        outputSchema: UpdateResultSchema,
+    }, async ({ id, content, semanticPatch, title, tags, lifecycle, role, summary, alwaysLoad, cwd, allowProtectedBranch = false }) => {
+        await ensureBranchSynced(ctx, cwd);
+        const noteId = memoryId(id);
+        const found = await ctx.vaultManager.findNote(id, cwd);
+        if (!found) {
+            return { content: [{ type: "text", text: `No memory found with id '${id}'` }], isError: true };
+        }
+        // Validate: content and semanticPatch are mutually exclusive
+        const hasContent = content !== undefined;
+        const hasSemanticPatch = semanticPatch !== undefined && semanticPatch.length > 0;
+        if (hasContent && hasSemanticPatch) {
+            return { content: [{ type: "text", text: "Exactly one of content or semanticPatch must be provided, not both." }], isError: true };
+        }
+        const { note, vault } = found;
+        if (vault.isProject) {
+            const resolvedProject = await resolveProject(ctx, cwd);
+            const projectLabel = resolvedProject
+                ? `${resolvedProject.name} (${resolvedProject.id})`
+                : `${note.projectName ?? "project"} (${note.project ?? "unknown"})`;
+            const policy = note.project ? await ctx.configStore.getProjectPolicy(note.project) : undefined;
+            const protectedBranchCheck = await shouldBlockProtectedBranchCommit({
+                ctx,
+                cwd,
+                writeScope: "project",
+                automaticCommit: true,
+                projectLabel,
+                policy,
+                allowProtectedBranch,
+                toolName: "update",
+            });
+            if (protectedBranchCheck.blocked) {
+                return {
+                    content: [{ type: "text", text: protectedBranchCheck.message ?? "Protected branch policy blocked this commit." }],
+                    isError: true,
+                };
+            }
+        }
+        const now = isoDateString(new Date().toISOString());
+        let patchedContent;
+        let lintWarnings;
+        if (semanticPatch && semanticPatch.length > 0) {
+            try {
+                const result = await applySemanticPatches(note.content, semanticPatch);
+                patchedContent = result.content;
+                lintWarnings = result.lintWarnings;
+            }
+            catch (err) {
+                if (err instanceof MarkdownLintError) {
+                    const message = `Semantic patch produced content with markdown lint issues. Fix the lint issues in your patch values and retry — do NOT fall back to full content rewrite.\n\n${err.message}`;
+                    return { content: [{ type: "text", text: message }], isError: true };
+                }
+                const message = getErrorMessage(err);
+                return { content: [{ type: "text", text: `Semantic patch failed: ${message}` }], isError: true };
+            }
+        }
+        let cleanedContent;
+        if (content !== undefined) {
+            try {
+                cleanedContent = await cleanMarkdown(content);
+            }
+            catch (err) {
+                if (err instanceof MarkdownLintError) {
+                    const message = `Markdown lint issues prevented the update. Fix the specific lint errors in your content and retry — do NOT fall back to semanticPatch for this.\n\n${err.message}`;
+                    return {
+                        content: [{ type: "text", text: message }],
+                        structuredContent: { action: "lint_error", tool: "update", issues: err.issues },
+                        isError: true,
+                    };
+                }
+                throw err;
+            }
+        }
+        const resolvedTitle = title ?? note.title;
+        const resolvedContent = patchedContent ?? cleanedContent ?? note.content;
+        const resolvedTags = tags ?? note.tags;
+        const resolvedLifecycle = lifecycle ?? note.lifecycle;
+        const resolvedRole = role !== undefined ? role : (note.role ? note.role : undefined);
+        const resolvedAlwaysLoad = alwaysLoad !== undefined ? alwaysLoad : note.alwaysLoad;
+        let relatedToChanged = false;
+        let resolvedRelatedTo = note.relatedTo;
+        if (note.project) {
+            const accessCandidates = getRecentSessionNoteAccesses(note.project)
+                .map((entry) => {
+                const cachedNote = getSessionCachedNote(note.project, entry.vaultPath, entry.noteId)
+                    ?? getRecentSessionAccessNote(note.project, entry.vaultPath, entry.noteId);
+                return cachedNote
+                    ? { note: cachedNote, accessedAt: entry.accessedAt, accessKind: entry.accessKind, score: entry.score }
+                    : null;
+            })
+                .filter((entry) => entry !== null);
+            const autoRelationships = suggestAutoRelationships({
+                ...note,
+                title: resolvedTitle,
+                content: resolvedContent,
+                tags: resolvedTags,
+                lifecycle: resolvedLifecycle,
+                alwaysLoad: resolvedAlwaysLoad,
+            }, accessCandidates);
+            if (autoRelationships.length > 0) {
+                const existing = [...(note.relatedTo ?? [])];
+                for (const relationship of autoRelationships) {
+                    if (!existing.some((rel) => rel.id === relationship.id && rel.type === relationship.type)) {
+                        existing.push(relationship);
+                    }
+                }
+                resolvedRelatedTo = existing;
+                relatedToChanged = true;
+            }
+        }
+        const changes = computeFieldsModified({
+            patchedContent,
+            originalContent: note.content,
+            contentExplicitlyProvided: content !== undefined,
+            semanticPatchProvided: semanticPatch !== undefined && semanticPatch.length > 0,
+            newTitle: resolvedTitle,
+            originalTitle: note.title,
+            titleExplicitlyProvided: title !== undefined,
+            newLifecycle: resolvedLifecycle,
+            originalLifecycle: note.lifecycle,
+            lifecycleExplicitlyProvided: lifecycle !== undefined,
+            newRole: resolvedRole,
+            originalRole: note.role,
+            roleExplicitlySet: role !== undefined,
+            newTags: resolvedTags,
+            originalTags: note.tags,
+            tagsExplicitlyProvided: tags !== undefined,
+            newAlwaysLoad: resolvedAlwaysLoad,
+            originalAlwaysLoad: note.alwaysLoad,
+            alwaysLoadExplicitlyProvided: alwaysLoad !== undefined,
+            relatedToChanged,
+        });
+        const hasChanges = hasActualChanges({
+            content: cleanedContent,
+            originalContent: note.content,
+            title,
+            originalTitle: note.title,
+            tags,
+            originalTags: note.tags,
+            lifecycle,
+            originalLifecycle: note.lifecycle,
+            role,
+            originalRole: note.role,
+            roleExplicitlySet: role !== undefined,
+            alwaysLoad,
+            originalAlwaysLoad: note.alwaysLoad,
+            semanticPatchApplied: semanticPatch !== undefined && semanticPatch.length > 0,
+            relatedToChanged,
+        });
+        if (!hasChanges) {
+            const noOpPersistence = {
+                notePath: vault.storage.notePath(memoryId(id)),
+                embeddingPath: vault.storage.embeddingPath(memoryId(id)),
+                embedding: { status: "skipped", model: embedModel, reason: "no-changes" },
+                git: {
+                    commit: "skipped",
+                    push: "skipped",
+                    commitReason: "no-changes",
+                    pushReason: "no-changes",
+                },
+                durability: "local-only",
+            };
+            return {
+                content: [{ type: "text", text: `No changes to memory '${id}'` }],
+                structuredContent: {
+                    action: "updated",
+                    id,
+                    title: note.title,
+                    fieldsModified: [],
+                    timestamp: note.updatedAt,
+                    project: noteProjectRef(note),
+                    lifecycle: note.lifecycle,
+                    role: note.role,
+                    persistence: noOpPersistence,
+                },
+            };
+        }
+        const updated = {
+            ...note,
+            title: resolvedTitle,
+            content: resolvedContent,
+            tags: resolvedTags,
+            lifecycle: resolvedLifecycle,
+            ...(role !== undefined ? { role: resolvedRole } : (note.role ? { role: note.role } : {})),
+            alwaysLoad: resolvedAlwaysLoad,
+            updatedAt: now,
+            relatedTo: resolvedRelatedTo,
+        };
+        await vault.storage.writeNote(updated);
+        const shouldReembed = patchedContent !== undefined || cleanedContent !== undefined;
+        let embeddingStatus = { status: "skipped", reason: shouldReembed ? undefined : "metadata-only" };
+        if (shouldReembed) {
+            try {
+                const text = await embedTextForNote(vault.storage, updated);
+                const vector = await embed(text);
+                await vault.storage.writeEmbedding({ id: noteId, model: embedModel, embedding: vector, updatedAt: now });
+                embeddingStatus = { status: "written" };
+            }
+            catch (err) {
+                embeddingStatus = { status: "skipped", reason: getErrorMessage(err) };
+                console.error(`[embedding] Re-embed failed for '${id}': ${err}`);
+            }
+        }
+        const changeDesc = changes.length > 0 ? `Updated ${changes.join(", ")}` : "No changes";
+        const commitSummary = summary ?? changeDesc;
+        const commitBody = formatCommitBody({
+            summary: commitSummary,
+            noteId: id,
+            noteTitle: updated.title,
+            projectName: updated.projectName,
+            tags: updated.tags,
+        });
+        const commitMessage = `update: ${updated.title}`;
+        const commitFiles = [ctx.vaultManager.noteRelPath(vault, id)];
+        const commitStatus = await vault.git.commitWithStatus(commitMessage, commitFiles, commitBody);
+        const pushStatus = commitStatus.status === "committed"
+            ? await pushAfterMutation(ctx, vault)
+            : { status: "skipped", reason: "commit-failed" };
+        const retry = buildMutationRetryContract({
+            commit: commitStatus,
+            commitMessage,
+            commitBody,
+            files: commitFiles,
+            cwd,
+            vault,
+            mutationApplied: true,
+        });
+        const persistence = buildPersistenceStatus({
+            storage: vault.storage,
+            id,
+            embedding: embeddingStatus,
+            commit: commitStatus,
+            push: pushStatus,
+            commitMessage,
+            commitBody,
+            retry,
+        });
+        const structuredContent = {
+            action: "updated",
+            id,
+            title: updated.title,
+            fieldsModified: changes,
+            timestamp: now,
+            project: noteProjectRef(updated),
+            lifecycle: updated.lifecycle,
+            role: updated.role,
+            lintWarnings: lintWarnings && lintWarnings.length > 0 ? lintWarnings : undefined,
+            persistence,
+        };
+        invalidateActiveProjectCache();
+        const fieldText = changes.length > 0 ? `\nfields modified: ${changes.join(", ")}` : "";
+        const warningsText = lintWarnings && lintWarnings.length > 0
+            ? `\nmarkdown lint warnings (not auto-fixable):\n- ${lintWarnings.join("\n- ")}`
+            : "";
+        return { content: [{ type: "text", text: `Updated memory '${id}'${fieldText}${warningsText}\n${formatPersistenceSummary(persistence)}` }], structuredContent };
+    });
+}
+//# sourceMappingURL=update.js.map

package/build/tools/update.js.map

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

package/build/tools/where-is-memory.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ServerContext } from "../server-context.js";
+export declare function registerWhereIsMemoryTool(server: McpServer, ctx: ServerContext): void;
+//# sourceMappingURL=where-is-memory.d.ts.map

package/build/tools/where-is-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"where-is-memory.d.ts","sourceRoot":"","sources":["../../src/tools/where-is-memory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAK1D,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,aAAa,GAAG,IAAI,CAgErF"}

package/build/tools/where-is-memory.js

@@ -0,0 +1,61 @@
+import { z } from "zod";
+import { ensureBranchSynced, noteProjectRef, projectParam } from "../helpers/project.js";
+import { storageLabel } from "../helpers/vault.js";
+import { WhereIsResultSchema, NoteIdSchema } from "../structured-content.js";
+export function registerWhereIsMemoryTool(server, ctx) {
+    server.registerTool("where_is_memory", {
+        title: "Where Is Memory",
+        description: "Locate which storage label and project association a memory currently has.\n\n" +
+            "Use this when:\n" +
+            "- You know the id and want to see where the memory lives\n" +
+            "- You are deciding whether a note should be moved between project storage locations\n\n" +
+            "Do not use this when:\n" +
+            "- You need the full note content; use `get`\n" +
+            "- You want to search for a note by topic; use `recall`\n\n" +
+            "Returns:\n" +
+            "- Title, project association, storage label, updated time, and relationship count\n\n" +
+            "Read-only.\n\n" +
+            "Typical next step:\n" +
+            "- Use `move_memory` if the storage location is wrong, or `get` for full inspection.",
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+        inputSchema: z.object({
+            id: NoteIdSchema.describe("Exact memory id. Use an id returned by `recall`, `list`, `recent_memories`, or `where_is`."),
+            cwd: projectParam,
+        }),
+        outputSchema: WhereIsResultSchema,
+    }, async ({ id, cwd }) => {
+        await ensureBranchSynced(ctx, cwd);
+        const found = await ctx.vaultManager.findNote(id, cwd);
+        if (!found) {
+            return { content: [{ type: "text", text: `No memory found with id '${id}'` }], isError: true };
+        }
+        const { note, vault } = found;
+        const vaultLabel = storageLabel(vault);
+        const projectDisplay = note.projectName && note.project
+            ? `${note.projectName} (${note.project})`
+            : note.projectName ?? note.project ?? "global";
+        const relatedCount = note.relatedTo?.length ?? 0;
+        const structuredContent = {
+            action: "located",
+            id: note.id,
+            title: note.title,
+            project: noteProjectRef(note),
+            vault: vaultLabel,
+            updatedAt: note.updatedAt,
+            relatedCount,
+        };
+        return {
+            content: [{
+                    type: "text",
+                    text: `'${note.title}' (${id})\nproject: ${projectDisplay} | stored: ${vaultLabel} | updated: ${note.updatedAt} | related: ${relatedCount}`,
+                }],
+            structuredContent,
+        };
+    });
+}
+//# sourceMappingURL=where-is-memory.js.map

package/build/tools/where-is-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"where-is-memory.js","sourceRoot":"","sources":["../../src/tools/where-is-memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACzF,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAsB,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAEjG,MAAM,UAAU,yBAAyB,CAAC,MAAiB,EAAE,GAAkB;IAC7E,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,KAAK,EAAE,iBAAiB;QACxB,WAAW,EACT,gFAAgF;YAChF,kBAAkB;YAClB,4DAA4D;YAC5D,yFAAyF;YACzF,yBAAyB;YACzB,+CAA+C;YAC/C,4DAA4D;YAC5D,YAAY;YACZ,uFAAuF;YACvF,gBAAgB;YAChB,sBAAsB;YACtB,qFAAqF;QACvF,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACrB;QACD,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,EAAE,EAAE,YAAY,CAAC,QAAQ,CAAC,4FAA4F,CAAC;YACvH,GAAG,EAAE,YAAY;SAClB,CAAC;QACF,YAAY,EAAE,mBAAmB;KAClC,EACD,KAAK,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE;QACpB,MAAM,kBAAkB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAEnC,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QACvD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,4BAA4B,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACjG,CAAC;QAED,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;QAC9B,MAAM,UAAU,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QACvC,MAAM,cAAc,GAAG,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,OAAO;YACrD,CAAC,CAAC,GAAG,IAAI,CAAC,WAAW,KAAK,IAAI,CAAC,OAAO,GAAG;YACzC,CAAC,CAAC,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,OAAO,IAAI,QAAQ,CAAC;QACjD,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC,CAAC;QAEjD,MAAM,iBAAiB,GAAkB;YACvC,MAAM,EAAE,SAAS;YACjB,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC;YAC7B,KAAK,EAAE,UAAU;YACjB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,YAAY;SACb,CAAC;QAEF,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,IAAI,CAAC,KAAK,MAAM,EAAE,eAAe,cAAc,cAAc,UAAU,eAAe,IAAI,CAAC,SAAS,eAAe,YAAY,EAAE;iBAC5I,CAAC;YACF,iBAAiB;SAClB,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/build/validation.d.ts

@@ -0,0 +1,24 @@
+import { z } from "zod";
+import type { Relationship } from "./storage.js";
+import type { NoteProjection } from "./structured-content.js";
+export declare const EmbeddingRecordSchema: z.ZodObject<{
+    id: z.ZodString;
+    model: z.ZodString;
+    embedding: z.ZodArray<z.ZodNumber>;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export declare const NoteProjectionSchema: z.ZodObject<{
+    noteId: z.ZodString;
+    title: z.ZodString;
+    summary: z.ZodString;
+    headings: z.ZodArray<z.ZodString>;
+    tags: z.ZodArray<z.ZodString>;
+    lifecycle: z.ZodOptional<z.ZodString>;
+    updatedAt: z.ZodOptional<z.ZodString>;
+    projectionText: z.ZodString;
+    generatedAt: z.ZodString;
+}, z.core.$strip>;
+export declare function validateRelatedTo(value: unknown): Relationship[] | undefined;
+export declare function validateEmbeddingRecord(raw: unknown): import("./storage.js").EmbeddingRecord | null;
+export declare function validateNoteProjection(raw: unknown): NoteProjection | null;
+//# sourceMappingURL=validation.d.ts.map

package/build/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAG9D,eAAO,MAAM,qBAAqB;;;;;iBAKhC,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;iBAU/B,CAAC;AAOH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,EAAE,GAAG,SAAS,CAa5E;AAED,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,cAAc,EAAE,eAAe,GAAG,IAAI,CAYnG;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAO1E"}

package/build/validation.js

@@ -0,0 +1,62 @@
+import { z } from "zod";
+import { memoryId, embeddingModelId, isoDateString } from "./brands.js";
+export const EmbeddingRecordSchema = z.object({
+    id: z.string(),
+    model: z.string(),
+    embedding: z.array(z.number()),
+    updatedAt: z.string(),
+});
+export const NoteProjectionSchema = z.object({
+    noteId: z.string(),
+    title: z.string(),
+    summary: z.string(),
+    headings: z.array(z.string()),
+    tags: z.array(z.string()),
+    lifecycle: z.string().optional(),
+    updatedAt: z.string().optional(),
+    projectionText: z.string(),
+    generatedAt: z.string(),
+});
+const RelationshipSchema = z.object({
+    id: z.string(),
+    type: z.enum(["related-to", "explains", "example-of", "supersedes", "derives-from", "follows"]),
+});
+export function validateRelatedTo(value) {
+    if (value === undefined || value === null)
+        return undefined;
+    if (!Array.isArray(value))
+        return undefined;
+    const validated = [];
+    for (const item of value) {
+        const result = RelationshipSchema.safeParse(item);
+        if (result.success) {
+            validated.push({ id: memoryId(result.data.id), type: result.data.type });
+        }
+        else {
+            console.error(`[validation] Skipping invalid relationship entry: ${JSON.stringify(result.error.issues)}`);
+        }
+    }
+    return validated.length > 0 ? validated : undefined;
+}
+export function validateEmbeddingRecord(raw) {
+    const result = EmbeddingRecordSchema.safeParse(raw);
+    if (result.success) {
+        return {
+            id: memoryId(result.data.id),
+            model: embeddingModelId(result.data.model),
+            embedding: result.data.embedding,
+            updatedAt: isoDateString(result.data.updatedAt),
+        };
+    }
+    console.error(`[validation] Embedding record validation failed: ${JSON.stringify(result.error.issues)}`);
+    return null;
+}
+export function validateNoteProjection(raw) {
+    const result = NoteProjectionSchema.safeParse(raw);
+    if (result.success) {
+        return result.data;
+    }
+    console.error(`[validation] Note projection validation failed: ${JSON.stringify(result.error.issues)}`);
+    return null;
+}
+//# sourceMappingURL=validation.js.map

package/build/validation.js.map

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

package/build/vault.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vault.d.ts","sourceRoot":"","sources":["../src/vault.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAIlC,MAAM,WAAW,KAAK;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,SAAS,EAAE,OAAO,CAAC;IACnB;;;;;OAKG;IACH,eAAe,EAAE,MAAM,CAAC;CACzB;AAID,qBAAa,YAAY;IACvB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB;;;OAGG;IACH,OAAO,CAAC,oBAAoB,CAA4B;IACxD;;;OAGG;IACH,OAAO,CAAC,sBAAsB,CAA8B;IAC5D,yDAAyD;IACzD,OAAO,CAAC,WAAW,CAAM;gBAEb,aAAa,EAAE,MAAM;IAK3B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAO/B;;;;;OAKG;IACG,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAMjE;;;;OAIG;IACG,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAMjE;;;;OAIG;IACG,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAa9E;;;OAGG;IACG,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,IAAI,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,GAAG,IAAI,CAAC;IAQtF,mGAAmG;IACnG,cAAc,IAAI,KAAK,EAAE;IAQzB;;;;OAIG;IACG,WAAW,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAqBjD,uEAAuE;IACvE,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAIjD;;;OAGG;IACG,mBAAmB,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAc7E,OAAO,CAAC,UAAU;IAIlB;;;;OAIG;YACW,oBAAoB;CAqDnC;AAmED,wBAAsB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAYvE"}
+{"version":3,"file":"vault.d.ts","sourceRoot":"","sources":["../src/vault.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAIlC,MAAM,WAAW,KAAK;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,SAAS,EAAE,OAAO,CAAC;IACnB;;;;;OAKG;IACH,eAAe,EAAE,MAAM,CAAC;CACzB;AAID,qBAAa,YAAY;IACvB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB;;;OAGG;IACH,OAAO,CAAC,oBAAoB,CAA4B;IACxD;;;OAGG;IACH,OAAO,CAAC,sBAAsB,CAA8B;IAC5D,yDAAyD;IACzD,OAAO,CAAC,WAAW,CAAM;gBAEb,aAAa,EAAE,MAAM;IAK3B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAO/B;;;;;OAKG;IACG,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAMjE;;;;OAIG;IACG,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAMjE;;;;OAIG;IACG,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAa9E;;;OAGG;IACG,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,IAAI,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,GAAG,IAAI,CAAC;IAStF,mGAAmG;IACnG,cAAc,IAAI,KAAK,EAAE;IAQzB;;;;OAIG;IACG,WAAW,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAqBjD,uEAAuE;IACvE,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAIjD;;;OAGG;IACG,mBAAmB,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAc7E,OAAO,CAAC,UAAU;IAIlB;;;;OAIG;YACW,oBAAoB;CAqDnC;AAqED,wBAAsB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAavE"}

package/build/vault.js

@@ -1,7 +1,9 @@
 import fs from "fs/promises";
 import path from "path";
 import { simpleGit } from "simple-git";
+import { debugLog, getErrorMessage } from "./error-utils.js";
 import { Storage } from "./storage.js";
+import { memoryId } from "./brands.js";
 import { GitOps } from "./git.js";
 // ── VaultManager ─────────────────────────────────────────────────────────────
 export class VaultManager {
@@ -72,8 +74,9 @@ export class VaultManager {
      * then falling back through all other known vaults and finally the main vault.
      */
     async findNote(id, cwd) {
+        const memoryIdArg = memoryId(id);
         for (const vault of await this.searchOrder(cwd)) {
-            const note = await vault.storage.readNote(id);
+            const note = await vault.storage.readNote(memoryIdArg);
             if (note)
                 return { note, vault };
         }
@@ -204,7 +207,8 @@ async function discoverSubmoduleVaultFolders(gitRoot) {
             .map(e => e.name)
             .sort();
     }
-    catch {
+    catch (err) {
+        debugLog("vault:discover-submodules", `failed: ${getErrorMessage(err)}`);
         return [];
     }
 }
@@ -229,11 +233,12 @@ async function findGitRoot(cwd, visited = new Set()) {
             }
         }
         catch {
-            // Not inside a submodule or git version does not support the flag; use current root.
+            debugLog("vault:find-git-root", "not inside a submodule or flag unsupported, using current root");
         }
         return trimmedRoot;
     }
-    catch {
+    catch (err) {
+        debugLog("vault:find-git-root", `failed: ${getErrorMessage(err)}`);
         return null;
     }
 }
@@ -243,7 +248,8 @@ export async function ensureGitignore(ignorePath) {
     try {
         existing = await fs.readFile(ignorePath, "utf-8");
     }
-    catch {
+    catch (err) {
+        debugLog("vault:ensure-gitignore", `no existing gitignore: ${getErrorMessage(err)}`);
         existing = "";
     }
     const missing = requiredLines.filter(line => !existing.includes(line));