@gopherine/obsidian-mcp 0.1.1

package/dist/lib/frontmatter.d.ts

@@ -0,0 +1,34 @@
+export interface Frontmatter {
+    type?: string;
+    project?: string;
+    status?: string;
+    created?: string;
+    updated?: string;
+    tags?: string[];
+    related?: string[];
+    [key: string]: unknown;
+}
+/**
+ * Parse markdown content with YAML frontmatter.
+ */
+export declare function parseFrontmatter(content: string): {
+    data: Frontmatter;
+    content: string;
+};
+/**
+ * Serialize frontmatter + content back to markdown.
+ */
+export declare function serializeFrontmatter(data: Frontmatter, content: string): string;
+/**
+ * Create frontmatter with defaults for a new note.
+ */
+export declare function createFrontmatter(overrides: Partial<Frontmatter>): Frontmatter;
+/**
+ * Merge new frontmatter values into existing frontmatter.
+ * Updates the `updated` field automatically.
+ */
+export declare function mergeFrontmatter(existing: Frontmatter, updates: Partial<Frontmatter>): Frontmatter;
+/**
+ * Validate frontmatter fields.
+ */
+export declare function validateFrontmatter(data: Frontmatter): string[];

package/dist/lib/frontmatter.js

@@ -0,0 +1,74 @@
+import matter from "gray-matter";
+const VALID_TYPES = [
+    "context", "adr", "brainstorm", "decision", "todo",
+    "incident", "pattern", "evaluation", "index",
+    "task", "learning", "session",
+];
+const VALID_STATUSES = [
+    "active", "resolved", "deprecated", "draft",
+    "backlog", "in-progress", "blocked", "done", "cancelled", "completed",
+];
+/**
+ * Parse markdown content with YAML frontmatter.
+ */
+export function parseFrontmatter(content) {
+    try {
+        const parsed = matter(content);
+        return { data: parsed.data, content: parsed.content };
+    }
+    catch {
+        // Malformed YAML — return empty frontmatter and raw content
+        return { data: {}, content };
+    }
+}
+/**
+ * Serialize frontmatter + content back to markdown.
+ */
+export function serializeFrontmatter(data, content) {
+    return matter.stringify(content, data);
+}
+/**
+ * Create frontmatter with defaults for a new note.
+ */
+export function createFrontmatter(overrides) {
+    const today = new Date().toISOString().slice(0, 10);
+    return {
+        type: overrides.type ?? "index",
+        status: overrides.status ?? "active",
+        created: overrides.created ?? today,
+        updated: today,
+        ...overrides,
+    };
+}
+/**
+ * Merge new frontmatter values into existing frontmatter.
+ * Updates the `updated` field automatically.
+ */
+export function mergeFrontmatter(existing, updates) {
+    const today = new Date().toISOString().slice(0, 10);
+    return {
+        ...existing,
+        ...updates,
+        updated: today,
+    };
+}
+/**
+ * Validate frontmatter fields.
+ */
+export function validateFrontmatter(data) {
+    const errors = [];
+    if (data.type && !VALID_TYPES.includes(data.type)) {
+        errors.push(`Invalid type "${data.type}". Must be one of: ${VALID_TYPES.join(", ")}`);
+    }
+    if (data.status && !VALID_STATUSES.includes(data.status)) {
+        errors.push(`Invalid status "${data.status}". Must be one of: ${VALID_STATUSES.join(", ")}`);
+    }
+    if (data.tags && !Array.isArray(data.tags)) {
+        errors.push(`Tags must be an array`);
+    }
+    if (data.related && !Array.isArray(data.related)) {
+        errors.push(`Related must be an array`);
+    }
+    return errors;
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/lib/frontmatter.js.map

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

package/dist/lib/frontmatter.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/frontmatter.test.js

@@ -0,0 +1,192 @@
+import { describe, it, expect, beforeEach, vi, afterEach } from "vitest";
+import { parseFrontmatter, serializeFrontmatter, createFrontmatter, mergeFrontmatter, validateFrontmatter } from "./frontmatter.js";
+describe("parseFrontmatter", () => {
+    const cases = [
+        {
+            name: "with frontmatter",
+            input: "---\ntitle: Test\nstatus: active\n---\n\nContent here",
+            expectedData: { title: "Test", status: "active" },
+            expectedContent: "\nContent here",
+        },
+        {
+            name: "without frontmatter",
+            input: "# Just markdown\n\nNo frontmatter",
+            expectedData: {},
+            expectedContent: "# Just markdown\n\nNo frontmatter",
+        },
+        {
+            name: "empty string",
+            input: "",
+            expectedData: {},
+            expectedContent: "",
+        },
+        {
+            name: "only frontmatter dashes",
+            input: "---\n---\n",
+            expectedData: {},
+            expectedContent: "",
+        },
+        {
+            name: "malformed YAML",
+            input: "---\ninvalid: [unclosed\n---\nContent",
+            expectedData: {},
+            expectedContent: "---\ninvalid: [unclosed\n---\nContent",
+        },
+        {
+            name: "with array field",
+            input: "---\ntags:\n  - tag1\n  - tag2\n---\nContent",
+            expectedData: { tags: ["tag1", "tag2"] },
+            expectedContent: "Content",
+        },
+        {
+            name: "with nested object",
+            input: "---\nmeta:\n  key: value\n---\nContent",
+            expectedData: { meta: { key: "value" } },
+            expectedContent: "Content",
+        },
+    ];
+    for (const c of cases) {
+        it(c.name, () => {
+            const result = parseFrontmatter(c.input);
+            expect(result.data).toEqual(c.expectedData);
+            expect(result.content).toBe(c.expectedContent);
+        });
+    }
+});
+describe("serializeFrontmatter", () => {
+    it("serializes with content", () => {
+        const data = { type: "adr", status: "active" };
+        const content = "# My ADR\n\nContent";
+        const result = serializeFrontmatter(data, content);
+        expect(result).toContain("---");
+        expect(result).toContain("type: adr");
+        expect(result).toContain("status: active");
+        expect(result).toContain("# My ADR");
+    });
+    it("serializes with empty content", () => {
+        const data = { type: "task" };
+        const result = serializeFrontmatter(data, "");
+        expect(result).toContain("type: task");
+    });
+    it("serializes array fields", () => {
+        const data = { tags: ["a", "b"] };
+        const result = serializeFrontmatter(data, "content");
+        expect(result).toContain("tags:");
+        expect(result).toContain("- a");
+        expect(result).toContain("- b");
+    });
+});
+describe("createFrontmatter", () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+        vi.setSystemTime(new Date("2024-01-15"));
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+    });
+    it("creates frontmatter with defaults", () => {
+        const result = createFrontmatter({});
+        expect(result.type).toBe("index");
+        expect(result.status).toBe("active");
+        expect(result.created).toBe("2024-01-15");
+        expect(result.updated).toBe("2024-01-15");
+    });
+    it("overrides defaults", () => {
+        const result = createFrontmatter({ type: "adr", status: "draft" });
+        expect(result.type).toBe("adr");
+        expect(result.status).toBe("draft");
+    });
+    it("preserves custom fields", () => {
+        const result = createFrontmatter({ custom: "value" });
+        expect(result.custom).toBe("value");
+    });
+    it("uses provided created date", () => {
+        const result = createFrontmatter({ created: "2023-12-01" });
+        expect(result.created).toBe("2023-12-01");
+        expect(result.updated).toBe("2024-01-15");
+    });
+});
+describe("mergeFrontmatter", () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+        vi.setSystemTime(new Date("2024-01-15"));
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+    });
+    it("merges new fields", () => {
+        const existing = { type: "adr", status: "draft" };
+        const result = mergeFrontmatter(existing, { status: "active" });
+        expect(result.type).toBe("adr");
+        expect(result.status).toBe("active");
+    });
+    it("adds new fields", () => {
+        const existing = { type: "task" };
+        const result = mergeFrontmatter(existing, { tags: ["urgent"] });
+        expect(result.type).toBe("task");
+        expect(result.tags).toEqual(["urgent"]);
+    });
+    it("updates the updated timestamp", () => {
+        const existing = { type: "adr", updated: "2023-01-01" };
+        const result = mergeFrontmatter(existing, {});
+        expect(result.updated).toBe("2024-01-15");
+    });
+    it("preserves existing fields not in updates", () => {
+        const existing = { type: "adr", project: "test", created: "2023-01-01" };
+        const result = mergeFrontmatter(existing, { status: "done" });
+        expect(result.type).toBe("adr");
+        expect(result.project).toBe("test");
+        expect(result.created).toBe("2023-01-01");
+        expect(result.status).toBe("done");
+    });
+});
+describe("validateFrontmatter", () => {
+    it("returns empty array for valid frontmatter", () => {
+        const data = { type: "adr", status: "active" };
+        expect(validateFrontmatter(data)).toEqual([]);
+    });
+    it("returns error for invalid type", () => {
+        const data = { type: "invalid" };
+        const errors = validateFrontmatter(data);
+        expect(errors.length).toBe(1);
+        expect(errors[0]).toContain("Invalid type");
+    });
+    it("returns error for invalid status", () => {
+        const data = { status: "invalid" };
+        const errors = validateFrontmatter(data);
+        expect(errors.length).toBe(1);
+        expect(errors[0]).toContain("Invalid status");
+    });
+    it("returns error when tags is not array", () => {
+        const data = { tags: "not-array" };
+        const errors = validateFrontmatter(data);
+        expect(errors.length).toBe(1);
+        expect(errors[0]).toContain("Tags must be an array");
+    });
+    it("returns error when related is not array", () => {
+        const data = { related: "not-array" };
+        const errors = validateFrontmatter(data);
+        expect(errors.length).toBe(1);
+        expect(errors[0]).toContain("Related must be an array");
+    });
+    it("returns multiple errors", () => {
+        const data = { type: "bad", status: "worse", tags: "nope" };
+        const errors = validateFrontmatter(data);
+        expect(errors.length).toBe(3);
+    });
+    it("accepts all valid types", () => {
+        const validTypes = ["context", "adr", "brainstorm", "decision", "todo", "incident", "pattern", "evaluation", "index", "task", "learning", "session"];
+        for (const type of validTypes) {
+            const errors = validateFrontmatter({ type });
+            expect(errors).toEqual([]);
+        }
+    });
+    it("accepts all valid statuses", () => {
+        const validStatuses = ["active", "resolved", "deprecated", "draft", "backlog", "in-progress", "blocked", "done", "cancelled", "completed"];
+        for (const status of validStatuses) {
+            const errors = validateFrontmatter({ status });
+            expect(errors).toEqual([]);
+        }
+    });
+});
+//# sourceMappingURL=frontmatter.test.js.map

package/dist/lib/frontmatter.test.js.map

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

package/dist/lib/project-detector.d.ts

@@ -0,0 +1,12 @@
+export declare function invalidateProjectMapCache(): void;
+/**
+ * Detect the project slug from a working directory.
+ *
+ * Strategy:
+ * 1. Strip worktree suffixes from cwd
+ * 2. Try exact match in project-map.json
+ * 3. Try matching cwd as a subdirectory of a mapped path
+ * 4. Try git root as a mapped path
+ * 5. Return null if no match
+ */
+export declare function detectProject(cwd: string, vaultPath: string): Promise<string | null>;

package/dist/lib/project-detector.js

@@ -0,0 +1,123 @@
+import { readFile } from "fs/promises";
+import { resolve } from "path";
+import { execFile } from "child_process";
+import { promisify } from "util";
+const execFileAsync = promisify(execFile);
+const CACHE_TTL_MS = 60_000; // 1 minute
+let cache = null;
+export function invalidateProjectMapCache() {
+    cache = null;
+}
+function setCache(entry) {
+    cache = entry;
+}
+function getCache(vaultPath) {
+    const now = Date.now();
+    if (cache && cache.vaultPath === vaultPath && now - cache.time < CACHE_TTL_MS) {
+        return cache.map;
+    }
+    return null;
+}
+/**
+ * Load the project map from the vault. Cache is keyed by vaultPath.
+ */
+async function loadProjectMap(vaultPath) {
+    const cached = getCache(vaultPath);
+    if (cached)
+        return cached;
+    const mapPath = resolve(vaultPath, "project-map.json");
+    try {
+        const raw = await readFile(mapPath, "utf-8");
+        const parsed = JSON.parse(raw);
+        if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+            return {};
+        }
+        const map = {};
+        for (const [key, value] of Object.entries(parsed)) {
+            if (typeof value === "string") {
+                map[key] = value;
+            }
+        }
+        setCache({ map, time: Date.now(), vaultPath });
+        return map;
+    }
+    catch (e) {
+        if (e?.code === "EACCES") {
+            console.error(`Warning: permission denied reading ${mapPath}`);
+        }
+        else if (e?.code !== "ENOENT" && !(e instanceof SyntaxError)) {
+            throw e;
+        }
+        return {};
+    }
+}
+/**
+ * Strip worktree suffixes from a path.
+ */
+function stripWorktreeSuffix(cwd) {
+    // Pattern: /path/to/project/.worktrees/feat-name
+    const worktreeMatch = cwd.match(/^(.+?)\/\.worktrees\/[^/]+/);
+    if (worktreeMatch)
+        return worktreeMatch[1];
+    // Pattern: /path/to/project/.claude/worktrees/feat/name
+    const claudeWorktreeMatch = cwd.match(/^(.+?)\/\.claude\/worktrees\/.+/);
+    if (claudeWorktreeMatch)
+        return claudeWorktreeMatch[1];
+    // Pattern: /path/to/project/.claude-worktrees/name
+    const oldWorktreeMatch = cwd.match(/^(.+?)\/\.claude-worktrees\/[^/]+/);
+    if (oldWorktreeMatch)
+        return oldWorktreeMatch[1];
+    return cwd;
+}
+/**
+ * Try to detect git root of current directory (async, non-blocking).
+ */
+async function getGitRoot(cwd) {
+    try {
+        const { stdout } = await execFileAsync("git", ["rev-parse", "--show-toplevel"], {
+            cwd,
+            timeout: 3000,
+        });
+        return stdout.trim();
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Detect the project slug from a working directory.
+ *
+ * Strategy:
+ * 1. Strip worktree suffixes from cwd
+ * 2. Try exact match in project-map.json
+ * 3. Try matching cwd as a subdirectory of a mapped path
+ * 4. Try git root as a mapped path
+ * 5. Return null if no match
+ */
+export async function detectProject(cwd, vaultPath) {
+    const map = await loadProjectMap(vaultPath);
+    const cleanCwd = stripWorktreeSuffix(cwd);
+    // Exact match
+    if (map[cleanCwd])
+        return map[cleanCwd];
+    // Subdirectory match
+    for (const [path, slug] of Object.entries(map)) {
+        if (cleanCwd.startsWith(path + "/") || cleanCwd === path) {
+            return slug;
+        }
+    }
+    // Git root match
+    const gitRoot = await getGitRoot(cwd);
+    if (gitRoot) {
+        const cleanGitRoot = stripWorktreeSuffix(gitRoot);
+        if (map[cleanGitRoot])
+            return map[cleanGitRoot];
+        for (const [path, slug] of Object.entries(map)) {
+            if (cleanGitRoot.startsWith(path + "/") || cleanGitRoot === path) {
+                return slug;
+            }
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=project-detector.js.map

package/dist/lib/project-detector.js.map

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

package/dist/lib/project-detector.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/project-detector.test.js

@@ -0,0 +1,117 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { mkdir, writeFile, rm } from "fs/promises";
+import { tmpdir } from "os";
+import { join } from "path";
+import { detectProject, invalidateProjectMapCache } from "./project-detector.js";
+describe("project-detector", () => {
+    let vaultRoot;
+    let originalCwd;
+    beforeEach(async () => {
+        vaultRoot = join(tmpdir(), `project-test-${Date.now()}-${Math.random().toString(36).slice(2)}`);
+        await mkdir(vaultRoot, { recursive: true });
+        originalCwd = process.cwd();
+        invalidateProjectMapCache();
+    });
+    afterEach(async () => {
+        process.chdir(originalCwd);
+        await rm(vaultRoot, { recursive: true, force: true });
+        invalidateProjectMapCache();
+    });
+    describe("detectProject", () => {
+        it("returns null when no project-map.json", async () => {
+            const result = await detectProject("/nonexistent/path", vaultRoot);
+            expect(result).toBeNull();
+        });
+        it("detects project from exact cwd match in project-map.json", async () => {
+            const projectMap = { "/Users/test/myproject": "myproject" };
+            await writeFile(join(vaultRoot, "project-map.json"), JSON.stringify(projectMap));
+            invalidateProjectMapCache();
+            const result = await detectProject("/Users/test/myproject", vaultRoot);
+            expect(result).toBe("myproject");
+        });
+        it("detects project from subdirectory of mapped path", async () => {
+            const projectMap = { "/Users/test/myproject": "myproject" };
+            await writeFile(join(vaultRoot, "project-map.json"), JSON.stringify(projectMap));
+            invalidateProjectMapCache();
+            const result = await detectProject("/Users/test/myproject/src/components", vaultRoot);
+            expect(result).toBe("myproject");
+        });
+        it("returns null for unmapped path", async () => {
+            const projectMap = { "/Users/test/other": "other" };
+            await writeFile(join(vaultRoot, "project-map.json"), JSON.stringify(projectMap));
+            invalidateProjectMapCache();
+            const result = await detectProject("/Users/test/unmapped", vaultRoot);
+            expect(result).toBeNull();
+        });
+        it("handles invalid JSON in project-map.json", async () => {
+            await writeFile(join(vaultRoot, "project-map.json"), "not valid json {{{");
+            invalidateProjectMapCache();
+            const result = await detectProject("/any/path", vaultRoot);
+            expect(result).toBeNull();
+        });
+        it("handles non-object project-map.json", async () => {
+            await writeFile(join(vaultRoot, "project-map.json"), JSON.stringify(["array", "not", "object"]));
+            invalidateProjectMapCache();
+            const result = await detectProject("/any/path", vaultRoot);
+            expect(result).toBeNull();
+        });
+        it("strips .worktrees suffix from cwd", async () => {
+            const projectMap = { "/Users/test/myproject": "myproject" };
+            await writeFile(join(vaultRoot, "project-map.json"), JSON.stringify(projectMap));
+            invalidateProjectMapCache();
+            const result = await detectProject("/Users/test/myproject/.worktrees/feat-x", vaultRoot);
+            expect(result).toBe("myproject");
+        });
+        it("strips .claude/worktrees suffix from cwd", async () => {
+            const projectMap = { "/Users/test/myproject": "myproject" };
+            await writeFile(join(vaultRoot, "project-map.json"), JSON.stringify(projectMap));
+            invalidateProjectMapCache();
+            const result = await detectProject("/Users/test/myproject/.claude/worktrees/feat/name", vaultRoot);
+            expect(result).toBe("myproject");
+        });
+        it("strips .claude-worktrees suffix from cwd", async () => {
+            const projectMap = { "/Users/test/myproject": "myproject" };
+            await writeFile(join(vaultRoot, "project-map.json"), JSON.stringify(projectMap));
+            invalidateProjectMapCache();
+            const result = await detectProject("/Users/test/myproject/.claude-worktrees/feat-name", vaultRoot);
+            expect(result).toBe("myproject");
+        });
+        it("ignores non-string values in project-map.json", async () => {
+            const projectMap = {
+                "/Users/test/good": "good",
+                "/Users/test/bad": 123,
+                "/Users/test/also-bad": null
+            };
+            await writeFile(join(vaultRoot, "project-map.json"), JSON.stringify(projectMap));
+            invalidateProjectMapCache();
+            const goodResult = await detectProject("/Users/test/good", vaultRoot);
+            expect(goodResult).toBe("good");
+            const badResult = await detectProject("/Users/test/bad", vaultRoot);
+            expect(badResult).toBeNull();
+        });
+        it("caches project-map.json", async () => {
+            const projectMap = { "/Users/test/cached": "cached" };
+            await writeFile(join(vaultRoot, "project-map.json"), JSON.stringify(projectMap));
+            invalidateProjectMapCache();
+            await detectProject("/Users/test/cached", vaultRoot);
+            await writeFile(join(vaultRoot, "project-map.json"), JSON.stringify({ "/Users/test/other": "other" }));
+            const result = await detectProject("/Users/test/cached", vaultRoot);
+            expect(result).toBe("cached");
+        });
+        it("cache invalidates for different vault path", async () => {
+            const projectMap1 = { "/Users/test/path1": "project1" };
+            await writeFile(join(vaultRoot, "project-map.json"), JSON.stringify(projectMap1));
+            invalidateProjectMapCache();
+            const vaultRoot2 = join(tmpdir(), `project-test-2-${Date.now()}`);
+            await mkdir(vaultRoot2, { recursive: true });
+            const projectMap2 = { "/Users/test/path1": "project2" };
+            await writeFile(join(vaultRoot2, "project-map.json"), JSON.stringify(projectMap2));
+            const result1 = await detectProject("/Users/test/path1", vaultRoot);
+            const result2 = await detectProject("/Users/test/path1", vaultRoot2);
+            expect(result1).toBe("project1");
+            expect(result2).toBe("project2");
+            await rm(vaultRoot2, { recursive: true, force: true });
+        });
+    });
+});
+//# sourceMappingURL=project-detector.test.js.map

package/dist/lib/project-detector.test.js.map

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

package/dist/lib/safe-external-path.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Validate that a path is safe to read from outside the vault.
+ * Used only by vault_init to scan git repos.
+ *
+ * Enforces:
+ * - Must be under $HOME
+ * - Must not contain .. or symlinks escaping home
+ * - Must be a git repository
+ */
+export declare function safeExternalPath(rawPath: string): Promise<string>;