@stoneforge/quarry 1.12.0 → 1.14.0

package/dist/external-sync/providers/folder/folder-fs.js

@@ -0,0 +1,300 @@
+/**
+ * Folder Filesystem Client
+ *
+ * Filesystem layer for the folder sync provider. Reads, writes, and lists
+ * markdown files with YAML frontmatter in a local directory tree.
+ *
+ * Follows the same API client pattern as github-api.ts — a focused,
+ * dependency-light module that handles I/O for a single provider.
+ *
+ * Uses the `yaml` package for frontmatter parsing/serialization.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as yaml from 'yaml';
+// ============================================================================
+// Error Types
+// ============================================================================
+/**
+ * Typed error for folder filesystem failures.
+ */
+export class FolderFsError extends Error {
+    /** The operation that failed */
+    operation;
+    /** The file path involved (if applicable) */
+    filePath;
+    /** The underlying system error code (e.g., 'ENOENT', 'EACCES') */
+    code;
+    constructor(message, operation, filePath = null, code = null, cause) {
+        super(message);
+        this.name = 'FolderFsError';
+        this.operation = operation;
+        this.filePath = filePath;
+        this.code = code;
+        this.cause = cause;
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, FolderFsError);
+        }
+    }
+    /**
+     * Whether this error is due to a missing file or directory
+     */
+    get isNotFound() {
+        return this.code === 'ENOENT';
+    }
+    /**
+     * Whether this error is due to a permission issue
+     */
+    get isPermissionError() {
+        return this.code === 'EACCES' || this.code === 'EPERM';
+    }
+}
+/**
+ * Type guard for FolderFsError
+ */
+export function isFolderFsError(error) {
+    return error instanceof FolderFsError;
+}
+// ============================================================================
+// Frontmatter Parsing / Serialization
+// ============================================================================
+/** Frontmatter delimiter */
+const FRONTMATTER_DELIMITER = '---';
+/**
+ * Parses YAML frontmatter from a markdown string.
+ *
+ * Expects the standard `---` delimited frontmatter block at the start of the file.
+ * Returns the body content and parsed frontmatter separately.
+ *
+ * @param raw - Raw file content (may or may not have frontmatter)
+ * @returns Parsed frontmatter and body content
+ */
+export function parseFrontmatter(raw) {
+    const trimmed = raw.trimStart();
+    if (!trimmed.startsWith(FRONTMATTER_DELIMITER)) {
+        return { content: raw, frontmatter: {} };
+    }
+    // Find the closing delimiter
+    const afterOpening = trimmed.indexOf('\n');
+    if (afterOpening === -1) {
+        return { content: raw, frontmatter: {} };
+    }
+    const rest = trimmed.slice(afterOpening + 1);
+    // Check for closing delimiter: could be at the very start (empty frontmatter)
+    // or after a newline
+    let closingIndex;
+    let yamlBlock;
+    if (rest.startsWith(FRONTMATTER_DELIMITER)) {
+        // Empty frontmatter block: ---\n---
+        closingIndex = 0;
+        yamlBlock = '';
+    }
+    else {
+        const nlClosing = rest.indexOf(`\n${FRONTMATTER_DELIMITER}`);
+        if (nlClosing === -1) {
+            // No closing delimiter found — treat entire file as content
+            return { content: raw, frontmatter: {} };
+        }
+        closingIndex = nlClosing + 1; // point to the start of ---
+        yamlBlock = rest.slice(0, nlClosing);
+    }
+    // Content starts after the closing delimiter line
+    const closingLineEnd = rest.indexOf('\n', closingIndex);
+    const body = closingLineEnd === -1 ? '' : rest.slice(closingLineEnd + 1);
+    let parsed;
+    try {
+        parsed = yaml.parse(yamlBlock);
+    }
+    catch {
+        // If YAML is malformed, treat the whole file as content
+        return { content: raw, frontmatter: {} };
+    }
+    // yaml.parse can return null for empty YAML blocks
+    const frontmatter = parsed !== null && typeof parsed === 'object' && !Array.isArray(parsed)
+        ? parsed
+        : {};
+    return { content: body, frontmatter };
+}
+/**
+ * Serializes frontmatter and content into a markdown string with YAML front matter.
+ *
+ * @param content - Markdown body content
+ * @param frontmatter - Frontmatter key-value pairs
+ * @returns Complete file content with frontmatter block
+ */
+export function serializeFrontmatter(content, frontmatter) {
+    const hasFields = Object.keys(frontmatter).length > 0;
+    if (!hasFields) {
+        return content;
+    }
+    const yamlStr = yaml.stringify(frontmatter, {
+        lineWidth: 0, // Don't wrap lines
+    }).trimEnd();
+    return `${FRONTMATTER_DELIMITER}\n${yamlStr}\n${FRONTMATTER_DELIMITER}\n${content}`;
+}
+// ============================================================================
+// Filesystem Operations
+// ============================================================================
+/**
+ * Reads a markdown file with YAML frontmatter from a folder.
+ *
+ * @param basePath - Absolute path to the base directory
+ * @param relativePath - Path relative to basePath (e.g., 'notes/meeting.md')
+ * @returns Parsed file content, frontmatter, and modification time
+ * @throws {FolderFsError} If the file cannot be read
+ */
+export async function readFile(basePath, relativePath) {
+    const fullPath = path.resolve(basePath, relativePath);
+    // Security: ensure the resolved path is within basePath
+    const resolvedBase = path.resolve(basePath);
+    if (!fullPath.startsWith(resolvedBase + path.sep) && fullPath !== resolvedBase) {
+        throw new FolderFsError(`Path traversal detected: "${relativePath}" resolves outside base directory`, 'read', relativePath, 'EACCES');
+    }
+    try {
+        const [raw, stat] = await Promise.all([
+            fs.promises.readFile(fullPath, 'utf-8'),
+            fs.promises.stat(fullPath),
+        ]);
+        const { content, frontmatter } = parseFrontmatter(raw);
+        return {
+            content,
+            frontmatter,
+            mtime: stat.mtimeMs,
+        };
+    }
+    catch (err) {
+        const sysErr = err;
+        throw new FolderFsError(`Failed to read file "${relativePath}": ${sysErr.message}`, 'read', relativePath, sysErr.code ?? null, sysErr);
+    }
+}
+/**
+ * Writes a markdown file with YAML frontmatter to a folder.
+ *
+ * Writes atomically by first writing to a temporary file in the same directory,
+ * then renaming. This prevents partial writes from corrupting files.
+ *
+ * @param basePath - Absolute path to the base directory
+ * @param relativePath - Path relative to basePath (e.g., 'notes/meeting.md')
+ * @param content - Markdown body content
+ * @param frontmatter - YAML frontmatter key-value pairs
+ * @throws {FolderFsError} If the file cannot be written
+ */
+export async function writeFile(basePath, relativePath, content, frontmatter) {
+    const fullPath = path.resolve(basePath, relativePath);
+    // Security: ensure the resolved path is within basePath
+    const resolvedBase = path.resolve(basePath);
+    if (!fullPath.startsWith(resolvedBase + path.sep) && fullPath !== resolvedBase) {
+        throw new FolderFsError(`Path traversal detected: "${relativePath}" resolves outside base directory`, 'write', relativePath, 'EACCES');
+    }
+    const serialized = serializeFrontmatter(content, frontmatter);
+    const dir = path.dirname(fullPath);
+    const tmpPath = `${fullPath}.tmp.${Date.now()}.${Math.random().toString(36).slice(2, 8)}`;
+    try {
+        // Ensure parent directories exist
+        await fs.promises.mkdir(dir, { recursive: true });
+        // Write to temp file, then rename for atomicity
+        await fs.promises.writeFile(tmpPath, serialized, 'utf-8');
+        await fs.promises.rename(tmpPath, fullPath);
+    }
+    catch (err) {
+        // Clean up temp file on failure
+        try {
+            await fs.promises.unlink(tmpPath);
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+        const sysErr = err;
+        throw new FolderFsError(`Failed to write file "${relativePath}": ${sysErr.message}`, 'write', relativePath, sysErr.code ?? null, sysErr);
+    }
+}
+/**
+ * Recursively lists all `.md` files in a directory tree.
+ *
+ * Excludes:
+ * - Dotfiles (files starting with `.`)
+ * - Files inside dot-directories (directories starting with `.`)
+ *
+ * @param basePath - Absolute path to the base directory
+ * @param options - Optional filtering (e.g., `since` timestamp)
+ * @returns Array of file entries with relative paths and modification times
+ * @throws {FolderFsError} If the directory cannot be read
+ */
+export async function listFiles(basePath, options) {
+    const resolvedBase = path.resolve(basePath);
+    const entries = [];
+    try {
+        await walkDirectory(resolvedBase, resolvedBase, entries, options?.since);
+    }
+    catch (err) {
+        const sysErr = err;
+        throw new FolderFsError(`Failed to list files in "${basePath}": ${sysErr.message}`, 'list', null, sysErr.code ?? null, sysErr);
+    }
+    // Sort by path for deterministic output
+    entries.sort((a, b) => a.path.localeCompare(b.path));
+    return entries;
+}
+/**
+ * Checks whether a file exists at the given relative path within a base directory.
+ *
+ * @param basePath - Absolute path to the base directory
+ * @param relativePath - Path relative to basePath (e.g., 'notes/meeting.md')
+ * @returns True if the file exists, false otherwise
+ */
+export async function fileExists(basePath, relativePath) {
+    try {
+        await fs.promises.access(path.join(basePath, relativePath));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// ============================================================================
+// Internal Helpers
+// ============================================================================
+/**
+ * Recursively walks a directory tree, collecting .md files.
+ *
+ * @param currentDir - Current directory being scanned
+ * @param baseDir - Root base directory (for computing relative paths)
+ * @param results - Accumulator array for found entries
+ * @param since - Optional mtime filter (milliseconds)
+ */
+async function walkDirectory(currentDir, baseDir, results, since) {
+    const dirEntries = await fs.promises.readdir(currentDir, {
+        withFileTypes: true,
+    });
+    const promises = [];
+    for (const entry of dirEntries) {
+        const name = entry.name;
+        // Skip dotfiles and dot-directories
+        if (name.startsWith('.')) {
+            continue;
+        }
+        const fullPath = path.join(currentDir, name);
+        if (entry.isDirectory()) {
+            // Recurse into subdirectories
+            promises.push(walkDirectory(fullPath, baseDir, results, since));
+        }
+        else if (entry.isFile() && name.endsWith('.md')) {
+            // Collect .md files
+            promises.push((async () => {
+                const stat = await fs.promises.stat(fullPath);
+                const mtime = stat.mtimeMs;
+                // Apply since filter
+                if (since !== undefined && mtime <= since) {
+                    return;
+                }
+                // Compute relative path with forward slashes
+                const relativePath = path
+                    .relative(baseDir, fullPath)
+                    .split(path.sep)
+                    .join('/');
+                results.push({ path: relativePath, mtime });
+            })());
+        }
+    }
+    await Promise.all(promises);
+}
+//# sourceMappingURL=folder-fs.js.map

package/dist/external-sync/providers/folder/folder-fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"folder-fs.js","sourceRoot":"","sources":["../../../../src/external-sync/providers/folder/folder-fs.ts"],"names":[],"mappings":"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"}

package/dist/external-sync/providers/folder/folder-provider.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Folder Provider
+ *
+ * ExternalProvider implementation for local folder-based document sync.
+ * No authentication needed — the project path (folder path) is the
+ * only configuration required.
+ *
+ * Provides a DocumentSyncAdapter for bidirectional synchronization
+ * between Stoneforge documents and markdown files on the local filesystem.
+ *
+ * Usage:
+ * ```typescript
+ * const provider = createFolderProvider();
+ * const connected = await provider.testConnection({ provider: 'folder', defaultProject: '/path/to/docs' });
+ * const adapter = provider.getDocumentAdapter();
+ * ```
+ */
+import type { ExternalProvider } from '@stoneforge/core';
+/**
+ * Create a folder provider for local filesystem document sync.
+ *
+ * The provider is always ready — no authentication or configuration
+ * beyond the folder path is needed.
+ *
+ * @returns A configured Folder ExternalProvider
+ */
+export declare function createFolderProvider(): ExternalProvider;
+//# sourceMappingURL=folder-provider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"folder-provider.d.ts","sourceRoot":"","sources":["../../../../src/external-sync/providers/folder/folder-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EACV,gBAAgB,EAIjB,MAAM,kBAAkB,CAAC;AAmE1B;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,IAAI,gBAAgB,CAEvD"}

package/dist/external-sync/providers/folder/folder-provider.js

@@ -0,0 +1,87 @@
+/**
+ * Folder Provider
+ *
+ * ExternalProvider implementation for local folder-based document sync.
+ * No authentication needed — the project path (folder path) is the
+ * only configuration required.
+ *
+ * Provides a DocumentSyncAdapter for bidirectional synchronization
+ * between Stoneforge documents and markdown files on the local filesystem.
+ *
+ * Usage:
+ * ```typescript
+ * const provider = createFolderProvider();
+ * const connected = await provider.testConnection({ provider: 'folder', defaultProject: '/path/to/docs' });
+ * const adapter = provider.getDocumentAdapter();
+ * ```
+ */
+import * as fs from 'node:fs';
+import { FolderDocumentAdapter } from './folder-document-adapter.js';
+// ============================================================================
+// Folder Provider
+// ============================================================================
+/**
+ * Folder ExternalProvider implementation.
+ *
+ * Provides connection testing (checks if path exists and is a directory)
+ * and a DocumentSyncAdapter for local folder sync.
+ *
+ * No token is needed — the `defaultProject` field in ProviderConfig
+ * specifies the folder path to sync with.
+ */
+class FolderProvider {
+    name = 'folder';
+    displayName = 'Folder';
+    supportedAdapters = ['document'];
+    documentAdapter;
+    constructor() {
+        this.documentAdapter = new FolderDocumentAdapter();
+    }
+    /**
+     * Test whether the configured folder path exists and is a directory.
+     *
+     * Uses `defaultProject` from the config as the folder path.
+     * Returns false if no path is configured or the path doesn't exist
+     * or isn't a directory.
+     *
+     * @param config - Provider configuration with defaultProject as folder path
+     * @returns true if the path exists and is a directory, false otherwise
+     */
+    async testConnection(config) {
+        const folderPath = config.defaultProject;
+        if (!folderPath) {
+            return false;
+        }
+        try {
+            const stat = await fs.promises.stat(folderPath);
+            return stat.isDirectory();
+        }
+        catch {
+            // Path doesn't exist or can't be accessed
+            return false;
+        }
+    }
+    /**
+     * Returns the FolderDocumentAdapter instance for document sync.
+     *
+     * @returns DocumentSyncAdapter for folder-based document sync
+     */
+    getDocumentAdapter() {
+        return this.documentAdapter;
+    }
+}
+// ============================================================================
+// Factory Function
+// ============================================================================
+/**
+ * Create a folder provider for local filesystem document sync.
+ *
+ * The provider is always ready — no authentication or configuration
+ * beyond the folder path is needed.
+ *
+ * @returns A configured Folder ExternalProvider
+ */
+export function createFolderProvider() {
+    return new FolderProvider();
+}
+//# sourceMappingURL=folder-provider.js.map

package/dist/external-sync/providers/folder/folder-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"folder-provider.js","sourceRoot":"","sources":["../../../../src/external-sync/providers/folder/folder-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAQ9B,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAErE,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E;;;;;;;;GAQG;AACH,MAAM,cAAc;IACT,IAAI,GAAG,QAAQ,CAAC;IAChB,WAAW,GAAG,QAAQ,CAAC;IACvB,iBAAiB,GAA+B,CAAC,UAAU,CAAC,CAAC;IAErD,eAAe,CAAwB;IAExD;QACE,IAAI,CAAC,eAAe,GAAG,IAAI,qBAAqB,EAAE,CAAC;IACrD,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,cAAc,CAAC,MAAsB;QACzC,MAAM,UAAU,GAAG,MAAM,CAAC,cAAc,CAAC;QACzC,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAChD,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,0CAA0C;YAC1C,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,kBAAkB;QAChB,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO,IAAI,cAAc,EAAE,CAAC;AAC9B,CAAC"}

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

@@ -0,0 +1,11 @@
+/**
+ * Folder Provider — exports for the folder external sync provider
+ *
+ * Exports the folder provider factory, document adapter, and
+ * filesystem utilities.
+ */
+export { createFolderProvider } from './folder-provider.js';
+export { FolderDocumentAdapter, createFolderDocumentAdapter, slugify, } from './folder-document-adapter.js';
+export { readFile, writeFile, listFiles, parseFrontmatter, serializeFrontmatter, FolderFsError, isFolderFsError, } from './folder-fs.js';
+export type { FolderFrontmatter, FolderFileReadResult, FolderFileEntry, ListFilesOptions, } from './folder-fs.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/external-sync/providers/folder/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAG5D,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,OAAO,GACR,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EACL,QAAQ,EACR,SAAS,EACT,SAAS,EACT,gBAAgB,EAChB,oBAAoB,EACpB,aAAa,EACb,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,gBAAgB,GACjB,MAAM,gBAAgB,CAAC"}

package/dist/external-sync/providers/folder/index.js

@@ -0,0 +1,13 @@
+/**
+ * Folder Provider — exports for the folder external sync provider
+ *
+ * Exports the folder provider factory, document adapter, and
+ * filesystem utilities.
+ */
+// Provider factory
+export { createFolderProvider } from './folder-provider.js';
+// Document adapter
+export { FolderDocumentAdapter, createFolderDocumentAdapter, slugify, } from './folder-document-adapter.js';
+// Filesystem client (re-export for convenience)
+export { readFile, writeFile, listFiles, parseFrontmatter, serializeFrontmatter, FolderFsError, isFolderFsError, } from './folder-fs.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/external-sync/providers/folder/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,mBAAmB;AACnB,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE5D,mBAAmB;AACnB,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,OAAO,GACR,MAAM,8BAA8B,CAAC;AAEtC,gDAAgD;AAChD,OAAO,EACL,QAAQ,EACR,SAAS,EACT,SAAS,EACT,gBAAgB,EAChB,oBAAoB,EACpB,aAAa,EACb,eAAe,GAChB,MAAM,gBAAgB,CAAC"}