@noesis-brain/mcp-server 2.0.1 → 2.1.1

package/dist/tools/index.d.ts

@@ -2,7 +2,27 @@
  * Tool registry for md-manager MCP server
  */
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { NoesisClient } from '../api/NoesisClient.js';
+import { NoesisClient, type Note } from '../api/NoesisClient.js';
+/**
+ * Resolve a user-supplied file path to a registered root + relative path,
+ * mirroring the sync resolver (see sync_notes): expand `~` / `%USERPROFILE%`
+ * against this machine's home, resolve to absolute, then prefix-match the input
+ * against each root's active path, preferring the longest (most specific) match.
+ * Returns null if the path isn't inside any known root.
+ *
+ * This is what lets get_note resolve an absolute clipboard path
+ * (e.g. C:\Users\me\Noesis\foo.md) against a tilde-stored cloud root (~/Noesis):
+ * the backend /notes/by-path route does a literal prefix compare and never
+ * expands `~`, so absolute paths can't match cloud roots there — resolving
+ * client-side and calling /notes/by-relative instead sidesteps that.
+ */
+export declare function resolvePathToRoot(filePath: string, roots: Array<{
+    id: number;
+    path?: string;
+}>): {
+    rootId: number;
+    relativePath: string;
+} | null;
 export interface ToolServices {
     client: NoesisClient;
     geminiApiKey?: string;
@@ -11,4 +31,75 @@ export interface ToolServices {
  * Register all MCP tools with the server
  */
 export declare function registerTools(server: McpServer, services: ToolServices): void;
+/**
+ * A cloud note in the exact shape the sync branches consume (matching the old
+ * getNotesForSync element). Built by adaptCloudNote from a single-note fetch
+ * (content + metadata) plus the authoritative hash from the root hash map.
+ */
+type CloudNoteRow = {
+    id: number;
+    relative_path: string;
+    hash: string;
+    modified_at: string;
+    content: string;
+    title: string | null;
+    description: string | null;
+    keywords: string | string[] | null;
+    edited_online_at: string | null;
+};
+/** Adapt a by-relative Note (+ its hash from the root hash map) into CloudNoteRow. */
+export declare function adaptCloudNote(n: Note, relativePath: string, hash: string): CloudNoteRow;
+/**
+ * Sync specific files by path (single-file or multi-file sync mode)
+ * @param force - If true, bypass hash check and always re-sync (useful for metadata regeneration)
+ * @param regenerateMetadata - If true, backend AI regenerates all metadata fields, overwriting existing values
+ */
+export declare function syncSpecificFiles(filePaths: string[], dryRun: boolean, client: NoesisClient, force?: boolean, regenerateMetadata?: boolean): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+/**
+ * Split leading YAML frontmatter from a markdown document.
+ *
+ * The opening `---` must be the very first line and the closing `---` must be on its
+ * own line (line-anchored). This deliberately does NOT use `indexOf('---', 3)`: a bare
+ * substring search matches a `---` inside a frontmatter value, a `---`/`----` thematic
+ * break in the body, or a `---` inside a code fence — which previously caused notes to
+ * be truncated / their frontmatter duplicated on sync.
+ *
+ * @returns raw = whole matched block incl. fences + trailing newline; inner = the YAML
+ *          between the fences; body = everything after the block. If there is no valid
+ *          leading frontmatter, raw/inner are '' and body is the full content.
+ */
+export declare function splitFrontmatter(content: string): {
+    raw: string;
+    inner: string;
+    body: string;
+};
+/**
+ * Update frontmatter in file content with new metadata values
+ * Preserves existing frontmatter structure and only updates specified fields
+ */
+export declare function updateFrontmatter(content: string, updates: {
+    title?: string;
+    description?: string;
+    keywords?: string[];
+}): string;
+/**
+ * Parse markdown content into structure: frontmatter, H1 heading, and body
+ */
+export declare function parseMarkdownStructure(content: string): {
+    frontmatter: string;
+    h1: string | null;
+    body: string;
+};
+/**
+ * Merge local content with cloud content
+ * Strategy: Cloud's H1 wins (Noesis edits), Local's body wins (local edits)
+ */
+export declare function mergeContent(localContent: string, cloudContent: string): string;
+export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAE,YAAY,EAAkG,MAAM,wBAAwB,CAAC;AAqJtJ,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,YAAY,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI,CAwpF7E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAE,YAAY,EAAyC,KAAK,IAAI,EAA2D,MAAM,wBAAwB,CAAC;AAqIjK;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAC1C;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAejD;AAqBD,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,YAAY,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI,CA44F7E;AA0DD;;;;GAIG;AACH,KAAK,YAAY,GAAG;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC;IACnC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC,CAAC;AAEF,sFAAsF;AACtF,wBAAgB,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY,CAYxF;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EAAE,EACnB,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,YAAY,EACpB,KAAK,GAAE,OAAe,EACtB,kBAAkB,GAAE,OAAe,GAClC,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAigBhF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAI9F;AA+DD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GACrE,MAAM,CA2FR;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd,CAqBA;AA4SD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAY/E"}