@stoneforge/quarry 1.13.0 → 1.14.0

package/dist/external-sync/adapters/document-sync-adapter.js

@@ -0,0 +1,325 @@
+/**
+ * Document Sync Adapter Utilities
+ *
+ * Shared field mapping logic for converting between Stoneforge documents and
+ * external document representations (e.g., Notion pages, Obsidian notes).
+ *
+ * These utilities are provider-agnostic — they handle the common conversion
+ * logic that all document sync providers need.
+ *
+ * Key functions:
+ * - documentToExternalDocumentInput: Convert a Stoneforge Document → ExternalDocumentInput for push
+ * - externalDocumentToDocumentUpdates: Convert an ExternalDocument → Partial<Document> for pull
+ * - diffDocumentUpdates: Return only changed fields between existing and updated document
+ * - computeExternalDocumentHash: Deterministic hash for change detection
+ */
+import { createHash } from 'crypto';
+// ============================================================================
+// System Categories
+// ============================================================================
+/**
+ * Document categories that are system-managed and should be excluded from
+ * external sync. These documents are structural (task descriptions, message
+ * content) and are synced through their parent element's sync adapter.
+ */
+export const SYSTEM_CATEGORIES = new Set([
+    'task-description',
+    'message-content',
+]);
+/**
+ * Checks whether a document category is a system category that should
+ * be excluded from document sync.
+ */
+export function isSystemCategory(category) {
+    return SYSTEM_CATEGORIES.has(category);
+}
+/**
+ * Checks whether a document should be included in external sync operations
+ * (link-all, push, pull). A document is syncable if:
+ * - It does not have a system category (task-description, message-content)
+ * - It has a non-empty title (null, undefined, or whitespace-only titles are excluded)
+ *
+ * Documents without titles are typically system-generated (messages, task descriptions)
+ * that happen to not have the system category set, or scratch documents. They all
+ * slugify to "untitled.md" and overwrite each other, so they must be excluded.
+ */
+export function isSyncableDocument(doc) {
+    if (isSystemCategory(doc.category))
+        return false;
+    if (!doc.title || doc.title.trim().length === 0)
+        return false;
+    return true;
+}
+// ============================================================================
+// Content Type Mapping
+// ============================================================================
+/**
+ * Maps Stoneforge ContentType to external document content type.
+ *
+ * Stoneforge uses 'markdown', 'text', and 'json'.
+ * External systems use 'markdown', 'text', and 'html'.
+ * JSON content is mapped to 'text' for external systems since most
+ * document providers don't have a native JSON content type.
+ */
+export function mapContentTypeToExternal(contentType) {
+    switch (contentType) {
+        case 'markdown':
+            return 'markdown';
+        case 'text':
+            return 'text';
+        case 'json':
+            // JSON doesn't have a direct external equivalent; map to text
+            return 'text';
+        default:
+            return 'text';
+    }
+}
+/**
+ * Maps external document content type to Stoneforge ContentType.
+ *
+ * External systems use 'markdown', 'text', and 'html'.
+ * HTML content is mapped to 'text' since Stoneforge doesn't have an HTML
+ * content type — the content is stored as-is, just categorized as text.
+ */
+export function mapContentTypeFromExternal(contentType) {
+    switch (contentType) {
+        case 'markdown':
+            return 'markdown';
+        case 'text':
+            return 'text';
+        case 'html':
+            // HTML doesn't have a direct Stoneforge equivalent; map to text
+            return 'text';
+        default:
+            return 'text';
+    }
+}
+/**
+ * Slugifies a library name for use as a directory name.
+ * Uses the same algorithm as the folder adapter's slugify function:
+ * lowercase, replace non-alphanumeric chars with hyphens, collapse
+ * consecutive hyphens, trim leading/trailing hyphens.
+ *
+ * @param name - Library name to slugify
+ * @returns Slugified directory name
+ */
+function slugifyLibraryName(name) {
+    const slug = name
+        .toLowerCase()
+        .replace(/[^a-z0-9-]/g, '-')
+        .replace(/-+/g, '-')
+        .replace(/^-|-$/g, '');
+    return slug || 'untitled';
+}
+/**
+ * Resolves the library path for a document by querying its parent-child
+ * dependencies. Builds a hierarchical path from the root library down
+ * to the document's immediate parent library.
+ *
+ * For example, if a document belongs to library "API Reference" which
+ * is a child of library "Documentation", the returned path would be
+ * "documentation/api-reference".
+ *
+ * Design decisions:
+ * - If a document belongs to multiple libraries, the first one found is used
+ * - Library names are slugified for directory names
+ * - If the document has no library parent, returns undefined
+ *
+ * @param api - API for querying dependencies and elements
+ * @param documentId - The document's element ID
+ * @returns The slugified library path (e.g., 'documentation/api-reference'), or undefined if not in a library
+ */
+export async function resolveDocumentLibraryPath(api, documentId) {
+    // Find parent-child dependencies where document is the child (blockedId)
+    const deps = await api.getDependencies(documentId, ['parent-child']);
+    if (deps.length === 0) {
+        return undefined;
+    }
+    // Find the first library parent
+    let libraryId;
+    for (const dep of deps) {
+        const parent = await api.get(dep.blockerId);
+        if (parent && parent.type === 'library') {
+            libraryId = dep.blockerId;
+            break;
+        }
+    }
+    if (!libraryId) {
+        return undefined;
+    }
+    // Walk up the library hierarchy to build the full path
+    const pathSegments = [];
+    let currentId = libraryId;
+    const visited = new Set(); // Prevent infinite loops from cycles
+    while (currentId && !visited.has(currentId)) {
+        visited.add(currentId);
+        const library = await api.get(currentId);
+        if (!library || library.type !== 'library') {
+            break;
+        }
+        pathSegments.unshift(slugifyLibraryName(library.name));
+        // Find the parent library of this library
+        const parentDeps = await api.getDependencies(currentId, ['parent-child']);
+        let foundParentLibrary = false;
+        for (const dep of parentDeps) {
+            const parent = await api.get(dep.blockerId);
+            if (parent && parent.type === 'library') {
+                currentId = dep.blockerId;
+                foundParentLibrary = true;
+                break;
+            }
+        }
+        if (!foundParentLibrary) {
+            break;
+        }
+    }
+    return pathSegments.length > 0 ? pathSegments.join('/') : undefined;
+}
+/**
+ * Batch-resolves library paths for multiple documents.
+ * More efficient than calling resolveDocumentLibraryPath individually
+ * since it can reuse cached library lookups.
+ *
+ * @param api - API for querying dependencies and elements
+ * @param documentIds - Array of document element IDs
+ * @returns Map from document ID to library path (undefined entries omitted)
+ */
+export async function resolveDocumentLibraryPaths(api, documentIds) {
+    const result = new Map();
+    for (const docId of documentIds) {
+        const libraryPath = await resolveDocumentLibraryPath(api, docId);
+        if (libraryPath) {
+            result.set(docId, libraryPath);
+        }
+    }
+    return result;
+}
+// ============================================================================
+// Push: Stoneforge Document → External Document
+// ============================================================================
+/**
+ * Converts a Stoneforge Document into an ExternalDocumentInput for
+ * creating/updating a page in an external system.
+ *
+ * Handles:
+ * - Title mapping (1:1, falls back to empty string if undefined)
+ * - Content mapping (1:1)
+ * - ContentType mapping (markdown/text → markdown/text, json → text)
+ * - Optional library path for directory-based organization
+ *
+ * @param doc - The Stoneforge document to convert
+ * @param libraryPath - Optional pre-computed library path for the document
+ * @returns ExternalDocumentInput ready for the provider adapter
+ */
+export function documentToExternalDocumentInput(doc, libraryPath) {
+    return {
+        title: doc.title ?? '',
+        content: doc.content,
+        contentType: mapContentTypeToExternal(doc.contentType),
+        ...(doc.category !== undefined && { category: doc.category }),
+        ...(doc.tags !== undefined && doc.tags.length > 0 && { tags: doc.tags }),
+        ...(libraryPath !== undefined && { libraryPath }),
+    };
+}
+// ============================================================================
+// Pull: External Document → Stoneforge Document Updates
+// ============================================================================
+/**
+ * Converts an ExternalDocument into a partial Document update object for
+ * applying external changes to a local Stoneforge document.
+ *
+ * Handles:
+ * - Title mapping (1:1)
+ * - Content mapping (1:1)
+ * - ContentType mapping (markdown/text/html → markdown/text/text)
+ *
+ * If existingDoc is provided, only changed fields are returned (diff mode).
+ * If existingDoc is undefined, all mappable fields are returned (create mode).
+ *
+ * @param externalDoc - The external document to convert
+ * @param existingDoc - The existing local document (undefined for new documents)
+ * @returns Partial<Document> with only the changed fields (or all fields if no existingDoc)
+ */
+export function externalDocumentToDocumentUpdates(externalDoc, existingDoc) {
+    const contentType = mapContentTypeFromExternal(externalDoc.contentType);
+    const fullUpdate = {
+        title: externalDoc.title,
+        content: externalDoc.content,
+        contentType,
+    };
+    // If no existing document, return full create input
+    if (!existingDoc) {
+        return fullUpdate;
+    }
+    // Diff mode: only return changed fields
+    return diffDocumentUpdates(existingDoc, fullUpdate);
+}
+// ============================================================================
+// Diff Utilities
+// ============================================================================
+/**
+ * Compares a full update against an existing document and returns only
+ * the fields that actually changed.
+ *
+ * This prevents unnecessary updates when pulling changes from external
+ * systems where the data hasn't actually changed.
+ *
+ * Compared fields: title, content, contentType, category, tags
+ */
+export function diffDocumentUpdates(existing, updates) {
+    const diff = {};
+    if (updates.title !== undefined && updates.title !== existing.title) {
+        diff.title = updates.title;
+    }
+    if (updates.content !== undefined && updates.content !== existing.content) {
+        diff.content = updates.content;
+    }
+    if (updates.contentType !== undefined &&
+        updates.contentType !== existing.contentType) {
+        diff.contentType = updates.contentType;
+    }
+    if (updates.category !== undefined &&
+        updates.category !== existing.category) {
+        diff.category = updates.category;
+    }
+    if (updates.tags !== undefined && !arraysEqual(updates.tags, existing.tags)) {
+        diff.tags = updates.tags;
+    }
+    return diff;
+}
+// ============================================================================
+// Hash Computation
+// ============================================================================
+/**
+ * Computes a deterministic hash of an ExternalDocument for change detection.
+ *
+ * The hash is based on the document's title, content, and contentType.
+ * Used by the sync engine to detect whether an external document has
+ * changed since the last sync, avoiding unnecessary pull operations.
+ *
+ * @param doc - The external document to hash
+ * @returns A hex-encoded SHA-256 hash string
+ */
+export function computeExternalDocumentHash(doc) {
+    const hash = createHash('sha256');
+    hash.update(doc.title);
+    hash.update('\0'); // null byte separator to avoid collisions
+    hash.update(doc.content);
+    hash.update('\0');
+    hash.update(doc.contentType);
+    return hash.digest('hex');
+}
+// ============================================================================
+// Internal Helpers
+// ============================================================================
+/**
+ * Compares two arrays for equality (order-independent).
+ */
+function arraysEqual(a, b) {
+    if (a.length !== b.length)
+        return false;
+    const sortedA = [...a].sort();
+    const sortedB = [...b].sort();
+    return sortedA.every((val, idx) => val === sortedB[idx]);
+}
+//# sourceMappingURL=document-sync-adapter.js.map

package/dist/external-sync/adapters/document-sync-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-sync-adapter.js","sourceRoot":"","sources":["../../../src/external-sync/adapters/document-sync-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAYpC,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAkC,IAAI,GAAG,CAAmB;IACxF,kBAAkB;IAClB,iBAAiB;CAClB,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAA0B;IACzD,OAAO,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AACzC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAa;IAC9C,IAAI,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC;QAAE,OAAO,KAAK,CAAC;IACjD,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9D,OAAO,IAAI,CAAC;AACd,CAAC;AAED,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAE/E;;;;;;;GAOG;AACH,MAAM,UAAU,wBAAwB,CACtC,WAAwB;IAExB,QAAQ,WAAW,EAAE,CAAC;QACpB,KAAK,UAAU;YACb,OAAO,UAAU,CAAC;QACpB,KAAK,MAAM;YACT,OAAO,MAAM,CAAC;QAChB,KAAK,MAAM;YACT,8DAA8D;YAC9D,OAAO,MAAM,CAAC;QAChB;YACE,OAAO,MAAM,CAAC;IAClB,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,0BAA0B,CACxC,WAAyC;IAEzC,QAAQ,WAAW,EAAE,CAAC;QACpB,KAAK,UAAU;YACb,OAAO,UAAU,CAAC;QACpB,KAAK,MAAM;YACT,OAAO,MAAM,CAAC;QAChB,KAAK,MAAM;YACT,gEAAgE;YAChE,OAAO,MAAM,CAAC;QAChB;YACE,OAAO,MAAM,CAAC;IAClB,CAAC;AACH,CAAC;AA8BD;;;;;;;;GAQG;AACH,SAAS,kBAAkB,CAAC,IAAY;IACtC,MAAM,IAAI,GAAG,IAAI;SACd,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAEzB,OAAO,IAAI,IAAI,UAAU,CAAC;AAC5B,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,GAAmB,EACnB,UAAqB;IAErB,yEAAyE;IACzE,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,eAAe,CAAC,UAAU,EAAE,CAAC,cAAgC,CAAC,CAAC,CAAC;IAEvF,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,gCAAgC;IAChC,IAAI,SAAgC,CAAC;IACrC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,GAAG,CAAU,GAAG,CAAC,SAAS,CAAC,CAAC;QACrD,IAAI,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YACxC,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC;YAC1B,MAAM;QACR,CAAC;IACH,CAAC;IAED,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,uDAAuD;IACvD,MAAM,YAAY,GAAa,EAAE,CAAC;IAClC,IAAI,SAAS,GAA0B,SAAS,CAAC;IACjD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC,CAAC,qCAAqC;IAExE,OAAO,SAAS,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5C,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAEvB,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,GAAG,CAA6B,SAAS,CAAC,CAAC;QACrE,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC3C,MAAM;QACR,CAAC;QAED,YAAY,CAAC,OAAO,CAAC,kBAAkB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAEvD,0CAA0C;QAC1C,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,eAAe,CAAC,SAAS,EAAE,CAAC,cAAgC,CAAC,CAAC,CAAC;QAC5F,IAAI,kBAAkB,GAAG,KAAK,CAAC;QAC/B,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;YAC7B,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,GAAG,CAAU,GAAG,CAAC,SAAS,CAAC,CAAC;YACrD,IAAI,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBACxC,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC;gBAC1B,kBAAkB,GAAG,IAAI,CAAC;gBAC1B,MAAM;YACR,CAAC;QACH,CAAC;QAED,IAAI,CAAC,kBAAkB,EAAE,CAAC;YACxB,MAAM;QACR,CAAC;IACH,CAAC;IAED,OAAO,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACtE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,GAAmB,EACnB,WAAwB;IAExB,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEzC,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;QAChC,MAAM,WAAW,GAAG,MAAM,0BAA0B,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACjE,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,+EAA+E;AAC/E,gDAAgD;AAChD,+EAA+E;AAE/E;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,+BAA+B,CAC7C,GAAa,EACb,WAAoB;IAEpB,OAAO;QACL,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,EAAE;QACtB,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,WAAW,EAAE,wBAAwB,CAAC,GAAG,CAAC,WAAW,CAAC;QACtD,GAAG,CAAC,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC;QAC7D,GAAG,CAAC,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC;QACxE,GAAG,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,CAAC;KAClD,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,wDAAwD;AACxD,+EAA+E;AAE/E;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,iCAAiC,CAC/C,WAA6B,EAC7B,WAAsB;IAEtB,MAAM,WAAW,GAAG,0BAA0B,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;IAExE,MAAM,UAAU,GAA2B;QACzC,KAAK,EAAE,WAAW,CAAC,KAAK;QACxB,OAAO,EAAE,WAAW,CAAC,OAAO;QAC5B,WAAW;KACZ,CAAC;IAEF,oDAAoD;IACpD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,wCAAwC;IACxC,OAAO,mBAAmB,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;AACtD,CAAC;AAED,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAkB,EAClB,OAA0B;IAE1B,MAAM,IAAI,GAA2B,EAAE,CAAC;IAExC,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,KAAK,QAAQ,CAAC,KAAK,EAAE,CAAC;QACpE,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC7B,CAAC;IAED,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,OAAO,KAAK,QAAQ,CAAC,OAAO,EAAE,CAAC;QAC1E,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IACjC,CAAC;IAED,IACE,OAAO,CAAC,WAAW,KAAK,SAAS;QACjC,OAAO,CAAC,WAAW,KAAK,QAAQ,CAAC,WAAW,EAC5C,CAAC;QACD,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IACzC,CAAC;IAED,IACE,OAAO,CAAC,QAAQ,KAAK,SAAS;QAC9B,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC,QAAQ,EACtC,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IACnC,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5E,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E;;;;;;;;;GASG;AACH,MAAM,UAAU,2BAA2B,CAAC,GAAqB;IAC/D,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAClC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACvB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,0CAA0C;IAC7D,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACzB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAClB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC7B,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC5B,CAAC;AAED,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E;;GAEG;AACH,SAAS,WAAW,CAAC,CAAoB,EAAE,CAAoB;IAC7D,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IACxC,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9B,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/dist/external-sync/index.d.ts

@@ -17,4 +17,7 @@ export { autoLinkTask } from './auto-link.js';
 export type { AutoLinkTaskParams, AutoLinkTaskResult } from './auto-link.js';
 export { createLinearProvider, createLinearPlaceholderProvider, } from './providers/linear/index.js';
 export type { CreateLinearProviderOptions } from './providers/linear/index.js';
+export { createNotionProvider, createNotionPlaceholderProvider, NotionDocumentAdapter, createNotionDocumentAdapter, extractTitleFromProperties, buildPageProperties, markdownToNotionBlocks, notionBlocksToMarkdown, NotionApiClient, NotionApiError, isNotionApiError, } from './providers/notion/index.js';
+export type { CreateNotionProviderOptions, NotionApiClientOptions, RateLimitState as NotionRateLimitState, NotionPage, NotionBlock, NotionBlockInput, NotionRichText, NotionAnnotations, NotionProperty, NotionDatabase, NotionDatabaseProperty, NotionDatabaseSchema, NotionUpdateDatabaseInput, } from './providers/notion/index.js';
+export { createFolderProvider, FolderDocumentAdapter, createFolderDocumentAdapter, slugify, } from './providers/folder/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/external-sync/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/external-sync/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,6BAA6B,EAC7B,gCAAgC,GACjC,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAGnE,OAAO,EACL,cAAc,EACd,eAAe,EACf,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,YAAY,EACZ,eAAe,EACf,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAChE,YAAY,EACV,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,oBAAoB,EACpB,+BAA+B,EAC/B,iBAAiB,EACjB,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACxB,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,gBAAgB,GACjB,MAAM,6BAA6B,CAAC;AACrC,YAAY,EACV,WAAW,EACX,WAAW,EACX,UAAU,EACV,sBAAsB,EACtB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,GACd,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAG7E,OAAO,EACL,oBAAoB,EACpB,+BAA+B,GAChC,MAAM,6BAA6B,CAAC;AACrC,YAAY,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/external-sync/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,6BAA6B,EAC7B,gCAAgC,GACjC,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAGnE,OAAO,EACL,cAAc,EACd,eAAe,EACf,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,YAAY,EACZ,eAAe,EACf,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAChE,YAAY,EACV,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,oBAAoB,EACpB,+BAA+B,EAC/B,iBAAiB,EACjB,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACxB,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,gBAAgB,GACjB,MAAM,6BAA6B,CAAC;AACrC,YAAY,EACV,WAAW,EACX,WAAW,EACX,UAAU,EACV,sBAAsB,EACtB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,GACd,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAG7E,OAAO,EACL,oBAAoB,EACpB,+BAA+B,GAChC,MAAM,6BAA6B,CAAC;AACrC,YAAY,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAG/E,OAAO,EACL,oBAAoB,EACpB,+BAA+B,EAC/B,qBAAqB,EACrB,2BAA2B,EAC3B,0BAA0B,EAC1B,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EACtB,eAAe,EACf,cAAc,EACd,gBAAgB,GACjB,MAAM,6BAA6B,CAAC;AACrC,YAAY,EACV,2BAA2B,EAC3B,sBAAsB,EACtB,cAAc,IAAI,oBAAoB,EACtC,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,sBAAsB,EACtB,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,2BAA2B,EAC3B,OAAO,GACR,MAAM,6BAA6B,CAAC"}

package/dist/external-sync/index.js

@@ -17,4 +17,8 @@ export { createGitHubProvider, createGitHubPlaceholderProvider, GitHubTaskAdapte
 export { autoLinkTask } from './auto-link.js';
 // Linear provider
 export { createLinearProvider, createLinearPlaceholderProvider, } from './providers/linear/index.js';
+// Notion provider
+export { createNotionProvider, createNotionPlaceholderProvider, NotionDocumentAdapter, createNotionDocumentAdapter, extractTitleFromProperties, buildPageProperties, markdownToNotionBlocks, notionBlocksToMarkdown, NotionApiClient, NotionApiError, isNotionApiError, } from './providers/notion/index.js';
+// Folder provider
+export { createFolderProvider, FolderDocumentAdapter, createFolderDocumentAdapter, slugify, } from './providers/folder/index.js';
 //# sourceMappingURL=index.js.map

package/dist/external-sync/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/external-sync/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,oBAAoB;AACpB,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,6BAA6B,EAC7B,gCAAgC,GACjC,MAAM,wBAAwB,CAAC;AAGhC,oBAAoB;AACpB,OAAO,EACL,cAAc,EACd,eAAe,EACf,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAOhC,cAAc;AACd,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAUhE,kBAAkB;AAClB,OAAO,EACL,oBAAoB,EACpB,+BAA+B,EAC/B,iBAAiB,EACjB,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACxB,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,gBAAgB,GACjB,MAAM,6BAA6B,CAAC;AAYrC,oBAAoB;AACpB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,kBAAkB;AAClB,OAAO,EACL,oBAAoB,EACpB,+BAA+B,GAChC,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/external-sync/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,oBAAoB;AACpB,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,6BAA6B,EAC7B,gCAAgC,GACjC,MAAM,wBAAwB,CAAC;AAGhC,oBAAoB;AACpB,OAAO,EACL,cAAc,EACd,eAAe,EACf,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAOhC,cAAc;AACd,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAUhE,kBAAkB;AAClB,OAAO,EACL,oBAAoB,EACpB,+BAA+B,EAC/B,iBAAiB,EACjB,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACxB,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,gBAAgB,GACjB,MAAM,6BAA6B,CAAC;AAYrC,oBAAoB;AACpB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,kBAAkB;AAClB,OAAO,EACL,oBAAoB,EACpB,+BAA+B,GAChC,MAAM,6BAA6B,CAAC;AAGrC,kBAAkB;AAClB,OAAO,EACL,oBAAoB,EACpB,+BAA+B,EAC/B,qBAAqB,EACrB,2BAA2B,EAC3B,0BAA0B,EAC1B,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EACtB,eAAe,EACf,cAAc,EACd,gBAAgB,GACjB,MAAM,6BAA6B,CAAC;AAiBrC,kBAAkB;AAClB,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,2BAA2B,EAC3B,OAAO,GACR,MAAM,6BAA6B,CAAC"}

package/dist/external-sync/provider-registry.d.ts

@@ -87,8 +87,9 @@ export declare function createProviderRegistry(): ProviderRegistry;
 /**
  * Create a ProviderRegistry with default providers registered.
  *
- * Registers placeholder providers for GitHub and Linear by default.
- * The actual provider implementations replace these when configured with API keys.
+ * Registers placeholder providers for GitHub, Linear, and Notion by default,
+ * plus the Folder provider (which needs no authentication and is always ready).
+ * The actual provider implementations replace placeholders when configured with API keys.
  *
  * @returns A ProviderRegistry with default providers
  */
@@ -96,12 +97,15 @@ export declare function createDefaultProviderRegistry(): ProviderRegistry;
 /**
  * Create a ProviderRegistry with real configured providers.
  *
- * Starts with placeholder providers for all known providers (GitHub, Linear),
+ * Starts with placeholder providers for all known providers (GitHub, Linear, Notion, Folder),
  * then replaces placeholders with real configured providers for any configs
  * that have a token set. This ensures providers without tokens remain as
  * placeholders (which throw descriptive errors), while configured providers
  * are ready for actual sync operations.
  *
+ * Note: The Folder provider is always ready (no token needed), so it is
+ * never replaced — it remains as-is from the default registry.
+ *
  * @param providerConfigs - Array of provider configurations (from settings)
  * @returns A ProviderRegistry with configured providers replacing placeholders
  */

package/dist/external-sync/provider-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider-registry.d.ts","sourceRoot":"","sources":["../../src/external-sync/provider-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,kBAAkB,CAAC;AAQ1B;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,mBAAmB,GAAG,kBAAkB,CAAC;CAC9E;AAMD;;;;;GAKG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuC;IAEjE;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAU1C;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAI/C;;;;OAIG;IACH,IAAI,IAAI,gBAAgB,EAAE;IAI1B;;;;;;OAMG;IACH,iBAAiB,CAAC,IAAI,EAAE,eAAe,GAAG,oBAAoB,EAAE;IAiBhE;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd;AA6BD;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,gBAAgB,CAEzD;AAED;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,IAAI,gBAAgB,CAKhE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gCAAgC,CAC9C,eAAe,EAAE,SAAS,cAAc,EAAE,GACzC,gBAAgB,CAkClB"}
+{"version":3,"file":"provider-registry.d.ts","sourceRoot":"","sources":["../../src/external-sync/provider-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,kBAAkB,CAAC;AAU1B;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,mBAAmB,GAAG,kBAAkB,CAAC;CAC9E;AAMD;;;;;GAKG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuC;IAEjE;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAU1C;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAI/C;;;;OAIG;IACH,IAAI,IAAI,gBAAgB,EAAE;IAI1B;;;;;;OAMG;IACH,iBAAiB,CAAC,IAAI,EAAE,eAAe,GAAG,oBAAoB,EAAE;IAiBhE;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd;AA6BD;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,gBAAgB,CAEzD;AAED;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,IAAI,gBAAgB,CAOhE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gCAAgC,CAC9C,eAAe,EAAE,SAAS,cAAc,EAAE,GACzC,gBAAgB,CA8ClB"}

package/dist/external-sync/provider-registry.js

@@ -17,6 +17,8 @@
  */
 import { createGitHubProvider, createGitHubPlaceholderProvider } from './providers/github/index.js';
 import { createLinearProvider, createLinearPlaceholderProvider } from './providers/linear/index.js';
+import { createNotionProvider, createNotionPlaceholderProvider } from './providers/notion/index.js';
+import { createFolderProvider } from './providers/folder/index.js';
 // ============================================================================
 // ProviderRegistry
 // ============================================================================
@@ -135,8 +137,9 @@ export function createProviderRegistry() {
 /**
  * Create a ProviderRegistry with default providers registered.
  *
- * Registers placeholder providers for GitHub and Linear by default.
- * The actual provider implementations replace these when configured with API keys.
+ * Registers placeholder providers for GitHub, Linear, and Notion by default,
+ * plus the Folder provider (which needs no authentication and is always ready).
+ * The actual provider implementations replace placeholders when configured with API keys.
  *
  * @returns A ProviderRegistry with default providers
  */
@@ -144,23 +147,32 @@ export function createDefaultProviderRegistry() {
     const registry = new ProviderRegistry();
     registry.register(createGitHubPlaceholderProvider());
     registry.register(createLinearPlaceholderProvider());
+    registry.register(createNotionPlaceholderProvider());
+    registry.register(createFolderProvider());
     return registry;
 }
 /**
  * Create a ProviderRegistry with real configured providers.
  *
- * Starts with placeholder providers for all known providers (GitHub, Linear),
+ * Starts with placeholder providers for all known providers (GitHub, Linear, Notion, Folder),
  * then replaces placeholders with real configured providers for any configs
  * that have a token set. This ensures providers without tokens remain as
  * placeholders (which throw descriptive errors), while configured providers
  * are ready for actual sync operations.
  *
+ * Note: The Folder provider is always ready (no token needed), so it is
+ * never replaced — it remains as-is from the default registry.
+ *
  * @param providerConfigs - Array of provider configurations (from settings)
  * @returns A ProviderRegistry with configured providers replacing placeholders
  */
 export function createConfiguredProviderRegistry(providerConfigs) {
     const registry = createDefaultProviderRegistry();
     for (const config of providerConfigs) {
+        // Folder provider doesn't need a token — it's always ready
+        if (config.provider === 'folder') {
+            continue;
+        }
         if (!config.token) {
             continue;
         }
@@ -180,6 +192,11 @@ export function createConfiguredProviderRegistry(providerConfigs) {
                     apiKey: config.token,
                 }));
                 break;
+            case 'notion':
+                registry.register(createNotionProvider({
+                    token: config.token,
+                }));
+                break;
             // Unknown providers are silently skipped — their placeholders remain
         }
     }

package/dist/external-sync/provider-registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider-registry.js","sourceRoot":"","sources":["../../src/external-sync/provider-registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"provider-registry.js","sourceRoot":"","sources":["../../src/external-sync/provider-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAUH,OAAO,EAAE,oBAAoB,EAAE,+BAA+B,EAAE,MAAM,6BAA6B,CAAC;AACpG,OAAO,EAAE,oBAAoB,EAAE,+BAA+B,EAAE,MAAM,6BAA6B,CAAC;AACpG,OAAO,EAAE,oBAAoB,EAAE,+BAA+B,EAAE,MAAM,6BAA6B,CAAC;AACpG,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAcnE,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E;;;;;GAKG;AACH,MAAM,OAAO,gBAAgB;IACV,SAAS,GAAG,IAAI,GAAG,EAA4B,CAAC;IAEjE;;;;;OAKG;IACH,QAAQ,CAAC,QAA0B;QACjC,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CACb,aAAa,QAAQ,CAAC,IAAI,2BAA2B;gBACnD,8CAA8C,CACjD,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED;;;;OAIG;IACH,IAAI;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED;;;;;;OAMG;IACH,iBAAiB,CAAC,IAAqB;QACrC,MAAM,OAAO,GAA2B,EAAE,CAAC;QAE3C,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;YAC/C,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC/C,SAAS;YACX,CAAC;YAED,MAAM,OAAO,GAAG,gBAAgB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YACjD,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;YACtC,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,IAAY;QACrB,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;CACF;AAED,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E;;GAEG;AACH,SAAS,gBAAgB,CACvB,QAA0B,EAC1B,IAAqB;IAErB,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,MAAM;YACT,OAAO,QAAQ,CAAC,cAAc,EAAE,EAAE,CAAC;QACrC,KAAK,UAAU;YACb,OAAO,QAAQ,CAAC,kBAAkB,EAAE,EAAE,CAAC;QACzC,KAAK,SAAS;YACZ,OAAO,QAAQ,CAAC,iBAAiB,EAAE,EAAE,CAAC;QACxC;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E;;;;GAIG;AACH,MAAM,UAAU,sBAAsB;IACpC,OAAO,IAAI,gBAAgB,EAAE,CAAC;AAChC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,6BAA6B;IAC3C,MAAM,QAAQ,GAAG,IAAI,gBAAgB,EAAE,CAAC;IACxC,QAAQ,CAAC,QAAQ,CAAC,+BAA+B,EAAE,CAAC,CAAC;IACrD,QAAQ,CAAC,QAAQ,CAAC,+BAA+B,EAAE,CAAC,CAAC;IACrD,QAAQ,CAAC,QAAQ,CAAC,+BAA+B,EAAE,CAAC,CAAC;IACrD,QAAQ,CAAC,QAAQ,CAAC,oBAAoB,EAAE,CAAC,CAAC;IAC1C,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,gCAAgC,CAC9C,eAA0C;IAE1C,MAAM,QAAQ,GAAG,6BAA6B,EAAE,CAAC;IAEjD,KAAK,MAAM,MAAM,IAAI,eAAe,EAAE,CAAC;QACrC,2DAA2D;QAC3D,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACjC,SAAS;QACX,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAClB,SAAS;QACX,CAAC;QAED,0DAA0D;QAC1D,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAErC,QAAQ,MAAM,CAAC,QAAQ,EAAE,CAAC;YACxB,KAAK,QAAQ;gBACX,QAAQ,CAAC,QAAQ,CACf,oBAAoB,CAAC;oBACnB,QAAQ,EAAE,QAAQ;oBAClB,KAAK,EAAE,MAAM,CAAC,KAAK;oBACnB,UAAU,EAAE,MAAM,CAAC,UAAU;oBAC7B,cAAc,EAAE,MAAM,CAAC,cAAc;iBACtC,CAAC,CACH,CAAC;gBACF,MAAM;YACR,KAAK,QAAQ;gBACX,QAAQ,CAAC,QAAQ,CACf,oBAAoB,CAAC;oBACnB,MAAM,EAAE,MAAM,CAAC,KAAK;iBACrB,CAAC,CACH,CAAC;gBACF,MAAM;YACR,KAAK,QAAQ;gBACX,QAAQ,CAAC,QAAQ,CACf,oBAAoB,CAAC;oBACnB,KAAK,EAAE,MAAM,CAAC,KAAK;iBACpB,CAAC,CACH,CAAC;gBACF,MAAM;YACR,qEAAqE;QACvE,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/external-sync/providers/folder/folder-document-adapter.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Folder Document Sync Adapter
+ *
+ * Implements the DocumentSyncAdapter interface for local folder-based
+ * document synchronization. Maps between Stoneforge documents and
+ * markdown files with YAML frontmatter in a local directory tree.
+ *
+ * Uses folder-fs.ts for all filesystem operations (read, write, list).
+ *
+ * Conventions:
+ * - project = absolute folder path (base directory)
+ * - externalId = relative file path within the folder (e.g., 'notes/meeting.md')
+ * - URL format: file:///absolute/path/to/file.md
+ * - Filenames are generated from titles using slugification
+ */
+import type { DocumentSyncAdapter, ExternalDocument, ExternalDocumentInput, Timestamp } from '@stoneforge/core';
+/**
+ * Converts a title string into a filename-safe slug.
+ *
+ * - Lowercases the string
+ * - Replaces non-alphanumeric characters (except hyphens) with hyphens
+ * - Collapses consecutive hyphens
+ * - Trims leading/trailing hyphens
+ * - Falls back to 'untitled' for empty results
+ *
+ * @param title - The document title to slugify
+ * @returns A filename-safe slug string (without extension)
+ */
+export declare function slugify(title: string): string;
+/**
+ * DocumentSyncAdapter implementation for local folder-based sync.
+ *
+ * Maps between Stoneforge ExternalDocument and markdown files with YAML
+ * frontmatter on the local filesystem.
+ *
+ * Usage:
+ * ```typescript
+ * const adapter = new FolderDocumentAdapter();
+ * const doc = await adapter.getPage('/path/to/docs', 'notes/meeting.md');
+ * ```
+ */
+export declare class FolderDocumentAdapter implements DocumentSyncAdapter {
+    /**
+     * Fetch a single document by its relative file path.
+     *
+     * @param project - Absolute path to the base directory
+     * @param externalId - Relative file path (e.g., 'notes/meeting.md')
+     * @returns The document as an ExternalDocument, or null if not found
+     */
+    getPage(project: string, externalId: string): Promise<ExternalDocument | null>;
+    /**
+     * List documents modified since a given timestamp.
+     *
+     * Reads each file to extract title and content, returning full
+     * ExternalDocument objects.
+     *
+     * @param project - Absolute path to the base directory
+     * @param since - ISO 8601 timestamp; only files modified after this are returned
+     * @returns Array of ExternalDocument objects for modified files
+     */
+    listPagesSince(project: string, since: Timestamp): Promise<ExternalDocument[]>;
+    /**
+     * Create a new document file in the folder.
+     *
+     * Generates a filename from the title using slugification, writes
+     * the content with frontmatter, and returns the created document.
+     *
+     * If the page has a `libraryPath`, the file is placed in the
+     * corresponding subdirectory. For example, a libraryPath of
+     * 'documentation/api' results in the file being created at
+     * 'documentation/api/my-doc.md'.
+     *
+     * @param project - Absolute path to the base directory
+     * @param page - Document input with title, content, and optional contentType
+     * @returns The created ExternalDocument
+     */
+    createPage(project: string, page: ExternalDocumentInput): Promise<ExternalDocument>;
+    /**
+     * Update an existing document file in the folder.
+     *
+     * Reads the existing file, merges the updates (preserving existing
+     * frontmatter), and writes back. Returns the updated document.
+     *
+     * @param project - Absolute path to the base directory
+     * @param externalId - Relative file path of the existing document
+     * @param updates - Partial document input with fields to update
+     * @returns The updated ExternalDocument
+     */
+    updatePage(project: string, externalId: string, updates: Partial<ExternalDocumentInput>): Promise<ExternalDocument>;
+}
+/**
+ * Creates a new FolderDocumentAdapter instance.
+ *
+ * @returns A configured FolderDocumentAdapter
+ */
+export declare function createFolderDocumentAdapter(): FolderDocumentAdapter;
+//# sourceMappingURL=folder-document-adapter.d.ts.map

package/dist/external-sync/providers/folder/folder-document-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"folder-document-adapter.d.ts","sourceRoot":"","sources":["../../../../src/external-sync/providers/folder/folder-document-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EACV,mBAAmB,EACnB,gBAAgB,EAChB,qBAAqB,EACrB,SAAS,EACV,MAAM,kBAAkB,CAAC;AAe1B;;;;;;;;;;;GAWG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQ7C;AAsBD;;;;;;;;;;;GAWG;AACH,qBAAa,qBAAsB,YAAW,mBAAmB;IAC/D;;;;;;OAMG;IACG,OAAO,CACX,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IA8BnC;;;;;;;;;OASG;IACG,cAAc,CAClB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,SAAS,GACf,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAuB9B;;;;;;;;;;;;;;OAcG;IACG,UAAU,CACd,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,gBAAgB,CAAC;IAqC5B;;;;;;;;;;OAUG;IACG,UAAU,CACd,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,OAAO,CAAC,qBAAqB,CAAC,GACtC,OAAO,CAAC,gBAAgB,CAAC;CAsC7B;AA6CD;;;;GAIG;AACH,wBAAgB,2BAA2B,IAAI,qBAAqB,CAEnE"}