roam-research-mcp/build/diff/index.js

MCP server and CLI for Roam Research

/**
 * Smart Diff Algorithm
 *
 * This module provides a diff algorithm for computing minimal update operations
 * when syncing markdown content to Roam Research. It preserves block UIDs where
 * possible and generates efficient batch actions.
 *
 * Usage:
 * ```typescript
 * import {
 *   parseExistingBlocks,
 *   markdownToBlocks,
 *   diffBlockTrees,
 *   generateBatchActions,
 *   getDiffStats
 * } from './diff/index.js';
 *
 * // 1. Parse existing page data
 * const existing = parseExistingBlocks(pageData);
 *
 * // 2. Convert new markdown to block structure
 * const newBlocks = markdownToBlocks(markdown, pageUid);
 *
 * // 3. Compute diff
 * const diff = diffBlockTrees(existing, newBlocks, pageUid);
 *
 * // 4. Generate ordered batch actions
 * const actions = generateBatchActions(diff);
 *
 * // 5. Check stats
 * const stats = getDiffStats(diff);
 * console.log(`Preserved ${stats.preserved} UIDs`);
 * ```
 */
export { getDiffStats, isDiffEmpty } from './types.js';
// Parser
export { parseExistingBlock, parseExistingBlocks, pruneHiddenExistingBlocks, countHiddenExistingBlocks, flattenExistingBlocks, markdownToBlocks, getBlockDepth, } from './parser.js';
// Matcher
export { normalizeText, normalizeForMatching, matchBlocks, groupByParent } from './matcher.js';
// Diff
export { diffBlockTrees, diffBlockLevel } from './diff.js';
// Actions
export { generateBatchActions, filterActions, groupActionsByType, summarizeActions, } from './actions.js';