pkm-mcp-server 1.0.0 → 1.1.1

package/CHANGELOG.md

@@ -6,12 +6,19 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [1.1.0] - 2026-02-23
+
+### Changed
+- `vault_peek` heading outline now displays as an indented tree instead of a flat list — hierarchy is conveyed by 2-space indentation per level, `#` markers stripped
+- `vault_peek` heading outline no longer includes line number prefixes (`L13`, `L15`, etc.)
+- `vault_peek` size line now always includes chunk count (e.g. "1 chunk", "3 chunks") instead of showing a separate `**Chunks:**` line only for multi-chunk files
+
 ## [1.0.0] - 2026-02-11
 
 ### Added
 - MCP server with 18 tools for Obsidian vault interaction
 - `vault_read` with pagination support (heading-based, tail lines, tail sections, chunk, line range); auto-redirects large files (>80k chars) to peek data; `force` param to bypass redirect (hard-capped at ~400k chars)
-- `vault_peek` for inspecting file metadata and structure without reading full content (size, frontmatter, heading outline with line numbers, preview)
+- `vault_peek` for inspecting file metadata and structure without reading full content (size, frontmatter, indented heading tree, preview)
 - `vault_write` with template-based note creation enforcing YAML frontmatter
 - `vault_append` with positional insert (after heading, before heading, end of section)
 - `vault_edit` for surgical single-occurrence string replacement
@@ -48,5 +55,6 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 - Atomic file creation in `vault_write` (`wx` flag) prevents race conditions
 - Error messages sanitized to prevent leaking absolute vault paths
 
-[Unreleased]: https://github.com/AdrianV101/Obsidian-MCP/compare/v1.0.0...HEAD
+[Unreleased]: https://github.com/AdrianV101/Obsidian-MCP/compare/v1.1.0...HEAD
+[1.1.0]: https://github.com/AdrianV101/Obsidian-MCP/compare/v1.0.0...v1.1.0
 [1.0.0]: https://github.com/AdrianV101/Obsidian-MCP/releases/tag/v1.0.0

package/helpers.js

@@ -12,6 +12,39 @@ const PRIORITY_RANKS = { urgent: 3, high: 2, normal: 1, low: 0 };
 const DATE_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
 const DANGEROUS_KEYS = new Set(["__proto__", "constructor", "prototype"]);
 
+// Canonical frontmatter field constraints, keyed by note type.
+// Used by vault_write (template-based) and vault_update_frontmatter (existing files).
+const FIELD_ENUMS = {
+  status: {
+    task: ["pending", "active", "done", "cancelled"],
+  },
+  priority: {
+    task: Object.keys(PRIORITY_RANKS),  // low, normal, high, urgent
+  },
+};
+
+/**
+ * Validate a frontmatter field value against FIELD_ENUMS for a given note type.
+ * Throws if the value is not in the allowed set.
+ *
+ * @param {string} fieldName - the frontmatter field (e.g. "status")
+ * @param {*} value - the value being set
+ * @param {string} noteType - the note's type field (e.g. "task")
+ */
+export function validateFieldEnum(fieldName, value, noteType) {
+  if (value === null || value === undefined) return;
+  const enumsByType = FIELD_ENUMS[fieldName];
+  if (!enumsByType) return;
+  const allowed = enumsByType[noteType];
+  if (!allowed) return;
+  const strValue = String(value);
+  if (!allowed.includes(strValue)) {
+    throw new Error(
+      `Invalid ${fieldName} "${strValue}" for type "${noteType}". Allowed values: ${allowed.join(", ")}`
+    );
+  }
+}
+
 /**
  * Compare two frontmatter values for sorting.
  * Smart ordering: priority uses custom ranks, dates sort chronologically, strings use localeCompare.
@@ -314,11 +347,18 @@ export function substituteTemplateVariables(content, vars) {
         }
       }
 
+      // Extract note type from template for enum validation
+      const typeMatch = frontmatterSection.match(/^type:\s*(.+)$/m);
+      const noteType = typeMatch ? typeMatch[1].trim() : null;
+
       for (const [key, value] of Object.entries(vars.frontmatter)) {
         if (key === "tags") continue;
         if (DANGEROUS_KEYS.has(key)) {
           throw new Error(`Disallowed frontmatter key: "${key}"`);
         }
+        if (noteType && typeof value === "string") {
+          validateFieldEnum(key, value, noteType);
+        }
         if (typeof value === "string") {
           if (!/^[a-zA-Z][a-zA-Z0-9_-]*$/.test(key)) {
             throw new Error(`Invalid frontmatter key: "${key}". Keys must start with a letter and contain only letters, digits, hyphens, or underscores.`);
@@ -746,10 +786,7 @@ export function formatPeek(peekData, { redirected = false } = {}) {
   const parts = [];
 
   parts.push(`## File: ${filePath}`);
-  parts.push(`**Size:** ${sizeChars.toLocaleString()} chars, ${sizeLines.toLocaleString()} lines`);
-  if (totalChunks > 1) {
-    parts.push(`**Chunks:** ${totalChunks} (use \`chunk\` param to read by chunk)`);
-  }
+  parts.push(`**Size:** ${sizeChars.toLocaleString()} chars, ${sizeLines.toLocaleString()} lines, ${totalChunks} ${totalChunks === 1 ? "chunk" : "chunks"}`);
 
   if (frontmatter) {
     parts.push("");
@@ -764,7 +801,9 @@ export function formatPeek(peekData, { redirected = false } = {}) {
     parts.push("");
     parts.push("### Heading Outline");
     for (const h of headings) {
-      parts.push(`L${h.lineNumber}  ${h.heading} (~${h.charCount} chars)`);
+      const indent = "  ".repeat(h.level - 1);
+      const title = h.heading.replace(/^#+\s*/, "");
+      parts.push(`${indent}${title} [${h.charCount} chars]`);
     }
   }
 
@@ -844,6 +883,11 @@ export function updateFrontmatter(content, fields) {
           throw new Error("tags must be a non-empty array");
         }
       }
+      // Use the file's existing type (or the new type if being changed) for enum validation
+      const effectiveType = key === "type" ? undefined : (fields.type || parsed.type);
+      if (effectiveType) {
+        validateFieldEnum(key, value, String(effectiveType));
+      }
       parsed[key] = value;
     }
   }

package/index.js

@@ -115,8 +115,8 @@ Pass custom <%...%> variables via the 'variables' parameter.`,
             description: "Frontmatter fields to set (e.g., {tags: ['tag1', 'tag2'], status: 'active'})",
             properties: {
               tags: { type: "array", items: { type: "string" }, description: "Tags for the note (required)" },
-              status: { type: "string", description: "Note status" },
-              priority: { type: "string", description: "Priority level (for tasks)" },
+              status: { type: "string", description: "Note status. For tasks: pending, active, done, cancelled" },
+              priority: { type: "string", description: "Priority level. For tasks: low, normal, high, urgent" },
               project: { type: "string", description: "Project name (for devlogs)" },
               deciders: { type: "string", description: "Decision makers (for ADRs)" },
               due: { type: "string", description: "Due date (for tasks)" },
@@ -157,7 +157,7 @@ Pass custom <%...%> variables via the 'variables' parameter.`,
     },
     {
       name: "vault_update_frontmatter",
-      description: "Update YAML frontmatter fields in an existing note. Parses existing frontmatter, updates specified fields, preserves everything else. Set a field to null to remove it. Protected fields (type, created, tags) cannot be removed.",
+      description: "Update YAML frontmatter fields in an existing note. Parses existing frontmatter, updates specified fields, preserves everything else. Set a field to null to remove it. Protected fields (type, created, tags) cannot be removed. Field values are validated against the note's type (e.g. task status must be: pending, active, done, cancelled; task priority must be: low, normal, high, urgent).",
       inputSchema: {
         type: "object",
         properties: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pkm-mcp-server",
-  "version": "1.0.0",
+  "version": "1.1.1",
   "description": "MCP server for Obsidian vault integration with Claude Code — 18 tools for notes, search, and graph traversal",
   "main": "index.js",
   "exports": {