obsidian-mcp-server 2.0.7 → 3.1.0

package/dist/services/obsidian/frontmatter-ops.js

@@ -0,0 +1,230 @@
+/**
+ * @fileoverview Read-modify-write helpers for the YAML frontmatter block of a
+ * note's raw content. Used by the composed manage-frontmatter / manage-tags
+ * tools when the upstream Local REST API has no single-call equivalent.
+ * @module services/obsidian/frontmatter-ops
+ */
+import { dump as yamlDump, load as yamlLoad } from 'js-yaml';
+const FM_RE = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?/;
+function splice(content) {
+    const m = FM_RE.exec(content);
+    if (!m)
+        return { hasFrontmatter: false, yamlText: '', body: content };
+    return {
+        hasFrontmatter: true,
+        yamlText: m[1] ?? '',
+        body: content.slice(m[0].length),
+    };
+}
+function loadFrontmatter(yamlText) {
+    const loaded = yamlLoad(yamlText);
+    return loaded && typeof loaded === 'object' ? loaded : {};
+}
+function emit(frontmatter, body) {
+    const keys = Object.keys(frontmatter);
+    if (keys.length === 0) {
+        return body.replace(/^\s+/, '');
+    }
+    const yamlText = yamlDump(frontmatter, { lineWidth: 1000, noRefs: true });
+    return `---\n${yamlText.trimEnd()}\n---\n${body.startsWith('\n') ? body.slice(1) : body}`;
+}
+/**
+ * Returns the full file content with `key` removed from the frontmatter.
+ * If the file has no frontmatter or the key isn't present, returns content
+ * unchanged.
+ */
+export function deleteFrontmatterKey(content, key) {
+    const { hasFrontmatter, yamlText, body } = splice(content);
+    if (!hasFrontmatter)
+        return content;
+    const fm = loadFrontmatter(yamlText);
+    if (!(key in fm))
+        return content;
+    delete fm[key];
+    return emit(fm, body);
+}
+/**
+ * Add or remove tags across frontmatter (`tags:` array) and inline `#tag`
+ * syntax. Inline occurrences inside fenced code blocks are left alone — they
+ * are code, not tags.
+ */
+export function reconcileTags(content, tags, operation, location) {
+    const norm = (t) => t.replace(/^#+/, '').trim();
+    const wanted = tags.map(norm).filter((t) => t.length > 0);
+    const applied = new Set();
+    const skipped = new Set();
+    let updated = content;
+    if (location === 'frontmatter' || location === 'both') {
+        updated = mutateFrontmatterTags(updated, wanted, operation, applied, skipped);
+    }
+    if (location === 'inline' || location === 'both') {
+        updated = mutateInlineTags(updated, wanted, operation, applied, skipped);
+    }
+    // For location='both', a tag that was already-in-frontmatter may have been
+    // missing inline (or vice versa). If applied is non-empty for the tag, drop
+    // it from skipped.
+    for (const t of applied)
+        skipped.delete(t);
+    return { content: updated, applied: [...applied], skipped: [...skipped] };
+}
+function mutateFrontmatterTags(content, tags, operation, applied, skipped) {
+    const { hasFrontmatter, yamlText, body } = splice(content);
+    const fm = hasFrontmatter ? { ...loadFrontmatter(yamlText) } : {};
+    const existing = normalizeTagList(fm.tags);
+    const set = new Set(existing);
+    let changed = false;
+    for (const tag of tags) {
+        if (operation === 'add') {
+            if (set.has(tag))
+                skipped.add(tag);
+            else {
+                set.add(tag);
+                applied.add(tag);
+                changed = true;
+            }
+        }
+        else {
+            if (set.has(tag)) {
+                set.delete(tag);
+                applied.add(tag);
+                changed = true;
+            }
+            else {
+                skipped.add(tag);
+            }
+        }
+    }
+    if (!changed)
+        return content;
+    const ordered = [...set];
+    if (ordered.length === 0) {
+        delete fm.tags;
+    }
+    else {
+        fm.tags = ordered;
+    }
+    if (Object.keys(fm).length === 0) {
+        return body.replace(/^\s+/, '');
+    }
+    return emit(fm, body);
+}
+function normalizeTagList(value) {
+    if (Array.isArray(value)) {
+        return value
+            .filter((v) => typeof v === 'string')
+            .map((v) => v.replace(/^#+/, '').trim())
+            .filter((v) => v.length > 0);
+    }
+    if (typeof value === 'string') {
+        return value
+            .split(/[\s,]+/)
+            .map((v) => v.replace(/^#+/, '').trim())
+            .filter((v) => v.length > 0);
+    }
+    return [];
+}
+const FENCED_CODE_BLOCK = /(```[\s\S]*?```|~~~[\s\S]*?~~~)/g;
+const INLINE_CODE = /(`[^`\n]+`)/g;
+function mutateInlineTags(content, tags, operation, applied, skipped) {
+    const segments = splitProtectedSegments(content);
+    let updatedNonCode = false;
+    if (operation === 'add') {
+        for (const tag of tags) {
+            const re = makeInlineTagRegex(tag);
+            const present = segments.some((s) => !s.protected && re.test(s.text));
+            if (present) {
+                skipped.add(tag);
+            }
+            else {
+                applied.add(tag);
+            }
+        }
+        const additions = tags
+            .filter((t) => applied.has(t))
+            .map((t) => `#${t}`)
+            .join(' ');
+        if (additions.length > 0) {
+            const trailing = segments.length > 0 ? (segments[segments.length - 1] ?? null) : null;
+            if (trailing && !trailing.protected) {
+                const sep = trailing.text.endsWith('\n') ? '' : '\n';
+                trailing.text = `${trailing.text}${sep}${additions}\n`;
+                updatedNonCode = true;
+            }
+            else {
+                segments.push({ protected: false, text: `\n${additions}\n` });
+                updatedNonCode = true;
+            }
+        }
+    }
+    else {
+        for (const tag of tags) {
+            const re = makeInlineTagRegex(tag);
+            let found = false;
+            for (const s of segments) {
+                if (s.protected)
+                    continue;
+                if (re.test(s.text)) {
+                    s.text = s.text.replace(re, (_full, leading) => leading);
+                    // collapse double spaces left behind
+                    s.text = s.text.replace(/[ \t]{2,}/g, ' ').replace(/ \n/g, '\n');
+                    found = true;
+                    updatedNonCode = true;
+                }
+            }
+            if (found)
+                applied.add(tag);
+            else
+                skipped.add(tag);
+        }
+    }
+    if (!updatedNonCode)
+        return content;
+    return segments.map((s) => s.text).join('');
+}
+function splitProtectedSegments(content) {
+    const segments = [];
+    let cursor = 0;
+    const re = new RegExp(`${FENCED_CODE_BLOCK.source}|${INLINE_CODE.source}`, 'g');
+    for (;;) {
+        const m = re.exec(content);
+        if (!m)
+            break;
+        const matched = m[0] ?? '';
+        if (m.index > cursor) {
+            segments.push({ protected: false, text: content.slice(cursor, m.index) });
+        }
+        segments.push({ protected: true, text: matched });
+        cursor = m.index + matched.length;
+    }
+    if (cursor < content.length) {
+        segments.push({ protected: false, text: content.slice(cursor) });
+    }
+    return segments;
+}
+function makeInlineTagRegex(tag) {
+    const escaped = tag.replace(/[\\^$.*+?()[\]{}|]/g, '\\$&');
+    return new RegExp(`(^|[^\\w/])#${escaped}(?![\\w/-])`, 'g');
+}
+/** Read-only helpers for `obsidian_manage_tags list`. */
+export function listTagsFromContent(content, frontmatter) {
+    const fmTags = normalizeTagList(frontmatter.tags);
+    const inline = [];
+    const seen = new Set();
+    for (const seg of splitProtectedSegments(content)) {
+        if (seg.protected)
+            continue;
+        const re = /(^|[^\w/])#([a-zA-Z][\w/-]*)/g;
+        for (;;) {
+            const m = re.exec(seg.text);
+            if (!m)
+                break;
+            const t = m[2];
+            if (t && !seen.has(t)) {
+                seen.add(t);
+                inline.push(t);
+            }
+        }
+    }
+    return { frontmatter: fmTags, inline };
+}
+//# sourceMappingURL=frontmatter-ops.js.map

package/dist/services/obsidian/frontmatter-ops.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter-ops.js","sourceRoot":"","sources":["../../../src/services/obsidian/frontmatter-ops.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,IAAI,QAAQ,EAAE,IAAI,IAAI,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE7D,MAAM,KAAK,GAAG,mCAAmC,CAAC;AASlD,SAAS,MAAM,CAAC,OAAe;IAC7B,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9B,IAAI,CAAC,CAAC;QAAE,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IACtE,OAAO;QACL,cAAc,EAAE,IAAI;QACpB,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;QACpB,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;KACjC,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,QAAgB;IACvC,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAA+C,CAAC;IAChF,OAAO,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5D,CAAC;AAED,SAAS,IAAI,CAAC,WAAoC,EAAE,IAAY;IAC9D,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACtC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAClC,CAAC;IACD,MAAM,QAAQ,GAAG,QAAQ,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1E,OAAO,QAAQ,QAAQ,CAAC,OAAO,EAAE,UAAU,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAC5F,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAe,EAAE,GAAW;IAC/D,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAC3D,IAAI,CAAC,cAAc;QAAE,OAAO,OAAO,CAAC;IACpC,MAAM,EAAE,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IACrC,IAAI,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC;QAAE,OAAO,OAAO,CAAC;IACjC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;IACf,OAAO,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;AACxB,CAAC;AAcD;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAC3B,OAAe,EACf,IAAc,EACd,SAAuB,EACvB,QAAqB;IAErB,MAAM,IAAI,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACxD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAElC,IAAI,OAAO,GAAG,OAAO,CAAC;IAEtB,IAAI,QAAQ,KAAK,aAAa,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;QACtD,OAAO,GAAG,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAChF,CAAC;IACD,IAAI,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;QACjD,OAAO,GAAG,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC3E,CAAC;IAED,2EAA2E;IAC3E,4EAA4E;IAC5E,mBAAmB;IACnB,KAAK,MAAM,CAAC,IAAI,OAAO;QAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAE3C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,EAAE,CAAC;AAC5E,CAAC;AAED,SAAS,qBAAqB,CAC5B,OAAe,EACf,IAAc,EACd,SAAuB,EACvB,OAAoB,EACpB,OAAoB;IAEpB,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAC3D,MAAM,EAAE,GAAG,cAAc,CAAC,CAAC,CAAC,EAAE,GAAG,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAElE,MAAM,QAAQ,GAAG,gBAAgB,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;IAC3C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC9B,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,SAAS,KAAK,KAAK,EAAE,CAAC;YACxB,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;iBAC9B,CAAC;gBACJ,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACb,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACjB,OAAO,GAAG,IAAI,CAAC;YACjB,CAAC;QACH,CAAC;aAAM,CAAC;YACN,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACjB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAChB,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACjB,OAAO,GAAG,IAAI,CAAC;YACjB,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACnB,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAO;QAAE,OAAO,OAAO,CAAC;IAE7B,MAAM,OAAO,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC;IACzB,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,CAAC,IAAI,CAAC;IACjB,CAAC;SAAM,CAAC;QACN,EAAE,CAAC,IAAI,GAAG,OAAO,CAAC;IACpB,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;AACxB,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IACtC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK;aACT,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC;aACjD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;aACvC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACjC,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK;aACT,KAAK,CAAC,QAAQ,CAAC;aACf,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;aACvC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,iBAAiB,GAAG,kCAAkC,CAAC;AAC7D,MAAM,WAAW,GAAG,cAAc,CAAC;AAEnC,SAAS,gBAAgB,CACvB,OAAe,EACf,IAAc,EACd,SAAuB,EACvB,OAAoB,EACpB,OAAoB;IAEpB,MAAM,QAAQ,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;IACjD,IAAI,cAAc,GAAG,KAAK,CAAC;IAE3B,IAAI,SAAS,KAAK,KAAK,EAAE,CAAC;QACxB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,EAAE,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;YACnC,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;YACtE,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACnB,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACnB,CAAC;QACH,CAAC;QACD,MAAM,SAAS,GAAG,IAAI;aACnB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;aAC7B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;aACnB,IAAI,CAAC,GAAG,CAAC,CAAC;QACb,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YACtF,IAAI,QAAQ,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;gBACpC,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;gBACrD,QAAQ,CAAC,IAAI,GAAG,GAAG,QAAQ,CAAC,IAAI,GAAG,GAAG,GAAG,SAAS,IAAI,CAAC;gBACvD,cAAc,GAAG,IAAI,CAAC;YACxB,CAAC;iBAAM,CAAC;gBACN,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,SAAS,IAAI,EAAE,CAAC,CAAC;gBAC9D,cAAc,GAAG,IAAI,CAAC;YACxB,CAAC;QACH,CAAC;IACH,CAAC;SAAM,CAAC;QACN,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,EAAE,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;YACnC,IAAI,KAAK,GAAG,KAAK,CAAC;YAClB,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;gBACzB,IAAI,CAAC,CAAC,SAAS;oBAAE,SAAS;gBAC1B,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;oBACpB,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,OAAe,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC;oBACjE,qCAAqC;oBACrC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;oBACjE,KAAK,GAAG,IAAI,CAAC;oBACb,cAAc,GAAG,IAAI,CAAC;gBACxB,CAAC;YACH,CAAC;YACD,IAAI,KAAK;gBAAE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;;gBACvB,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED,IAAI,CAAC,cAAc;QAAE,OAAO,OAAO,CAAC;IACpC,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC9C,CAAC;AAOD,SAAS,sBAAsB,CAAC,OAAe;IAC7C,MAAM,QAAQ,GAAc,EAAE,CAAC;IAC/B,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,MAAM,EAAE,GAAG,IAAI,MAAM,CAAC,GAAG,iBAAiB,CAAC,MAAM,IAAI,WAAW,CAAC,MAAM,EAAE,EAAE,GAAG,CAAC,CAAC;IAChF,SAAS,CAAC;QACR,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3B,IAAI,CAAC,CAAC;YAAE,MAAM;QACd,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC3B,IAAI,CAAC,CAAC,KAAK,GAAG,MAAM,EAAE,CAAC;YACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC5E,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QAClD,MAAM,GAAG,CAAC,CAAC,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC;IACpC,CAAC;IACD,IAAI,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;QAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,kBAAkB,CAAC,GAAW;IACrC,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;IAC3D,OAAO,IAAI,MAAM,CAAC,eAAe,OAAO,aAAa,EAAE,GAAG,CAAC,CAAC;AAC9D,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,mBAAmB,CACjC,OAAe,EACf,WAAoC;IAKpC,MAAM,MAAM,GAAG,gBAAgB,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAClD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,GAAG,IAAI,sBAAsB,CAAC,OAAO,CAAC,EAAE,CAAC;QAClD,IAAI,GAAG,CAAC,SAAS;YAAE,SAAS;QAC5B,MAAM,EAAE,GAAG,+BAA+B,CAAC;QAC3C,SAAS,CAAC;YACR,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC5B,IAAI,CAAC,CAAC;gBAAE,MAAM;YACd,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YACf,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gBACtB,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBACZ,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACjB,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AACzC,CAAC"}

package/dist/services/obsidian/obsidian-service.d.ts

@@ -0,0 +1,83 @@
+/**
+ * @fileoverview Obsidian Local REST API service. Wraps every upstream HTTP
+ * endpoint we use, builds the right URL/headers/body for the consolidated
+ * `target` discriminator, and classifies errors for the framework.
+ * @module services/obsidian/obsidian-service
+ */
+import type { Context } from '@cyanheads/mcp-ts-core';
+import { type Dispatcher, type RequestInit, fetch as undiciFetch } from 'undici';
+import { type ServerConfig } from '../../config/server-config.js';
+import type { DocumentMap, FileListing, NoteJson, NoteTarget, ObsidianCommand, ObsidianTag, PatchHeaders, StructuredSearchHit, TextSearchHit, VaultStatus } from './types.js';
+type UndiciResponse = Awaited<ReturnType<typeof undiciFetch>>;
+/**
+ * The HTTP fetch contract this service depends on. Defaults to undici's
+ * `fetch`; tests inject a stub here instead of mocking the `undici` module
+ * (Bun's runtime treats `undici` as a builtin, so `vi.mock('undici')` has no
+ * effect under `bunx vitest`).
+ */
+export type ObsidianFetch = (url: string, init: RequestInit & {
+    dispatcher?: Dispatcher;
+    signal?: AbortSignal;
+}) => Promise<UndiciResponse>;
+export declare class ObsidianService {
+    #private;
+    /**
+     * @param config - Validated server config (api key, base URL, TLS, timeouts).
+     * @param fetchImpl - Optional fetch override for tests. Defaults to undici's
+     *   `fetch`, which honors the constructed TLS dispatcher in production.
+     */
+    constructor(config: ServerConfig, fetchImpl?: ObsidianFetch);
+    getStatus(ctx: Context): Promise<VaultStatus>;
+    /**
+     * Probe whether the configured `OBSIDIAN_API_KEY` is accepted. Hits the
+     * authenticated `/vault/` listing endpoint and reports `true` only on a 2xx
+     * response. Network/auth errors yield `false` — the resource caller wants a
+     * boolean, not an exception. Aborts are re-thrown so cancellation/timeout
+     * doesn't masquerade as an auth failure.
+     */
+    probeAuthenticated(ctx: Context): Promise<boolean>;
+    getNoteContent(ctx: Context, target: NoteTarget): Promise<string>;
+    getNoteJson(ctx: Context, target: NoteTarget): Promise<NoteJson>;
+    /**
+     * Resolve `target` to a vault-relative path. For path targets this is a
+     * no-op; for `active` and `periodic` targets we have to ask upstream which
+     * concrete file is currently in play.
+     */
+    resolvePath(ctx: Context, target: NoteTarget): Promise<string>;
+    getDocumentMap(ctx: Context, target: NoteTarget): Promise<DocumentMap>;
+    writeNote(ctx: Context, target: NoteTarget, content: string, contentType?: 'markdown' | 'json'): Promise<void>;
+    appendToNote(ctx: Context, target: NoteTarget, content: string, contentType?: 'markdown' | 'json'): Promise<void>;
+    patchNote(ctx: Context, target: NoteTarget, content: string, headers: PatchHeaders): Promise<void>;
+    deleteNote(ctx: Context, target: NoteTarget): Promise<void>;
+    /**
+     * Probe whether a note exists at the target. Returns `true` on 2xx,
+     * `false` on 404. Any other status (auth, server) is surfaced through the
+     * normal error classifier so callers don't silently proceed past an actual
+     * problem (e.g. treating a 401 as "doesn't exist" and overwriting blindly).
+     *
+     * Bypasses `#request` retries: a HEAD probe should never be retried — a
+     * 404 is the answer, not a transient failure.
+     */
+    noteExists(ctx: Context, target: NoteTarget): Promise<boolean>;
+    listFiles(ctx: Context, dirPath?: string): Promise<FileListing>;
+    listTags(ctx: Context): Promise<ObsidianTag[]>;
+    listCommands(ctx: Context): Promise<ObsidianCommand[]>;
+    searchText(ctx: Context, query: string, contextLength?: number): Promise<TextSearchHit[]>;
+    searchDataview(ctx: Context, dql: string): Promise<StructuredSearchHit[]>;
+    searchJsonLogic(ctx: Context, logic: Record<string, unknown>): Promise<StructuredSearchHit[]>;
+    executeCommand(ctx: Context, commandId: string): Promise<void>;
+    openInUi(ctx: Context, path: string, opts?: {
+        newLeaf?: boolean;
+    }): Promise<void>;
+}
+/**
+ * Encode a vault-relative path for the URL. Each segment is URL-encoded so
+ * folder slashes are preserved while spaces and unicode are escaped.
+ */
+export declare function encodeVaultPath(path: string): string;
+export declare function initObsidianService(config?: ServerConfig, fetchImpl?: ObsidianFetch): void;
+/** Test-only: directly install an instance (e.g., one backed by a stub fetch). */
+export declare function setObsidianService(service: ObsidianService | undefined): void;
+export declare function getObsidianService(): ObsidianService;
+export {};
+//# sourceMappingURL=obsidian-service.d.ts.map

package/dist/services/obsidian/obsidian-service.d.ts.map

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