@waymakeros/cli 2.0.0

package/dist/sync/file-watcher.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Waymaker Sync - File Watcher
+ * Monitors markdown files for changes and emits events
+ */
+import { EventEmitter } from 'events';
+export interface FileWatcherOptions {
+    watchPatterns: string[];
+    ignorePatterns: string[];
+    projectPath: string;
+    debounceMs?: number;
+}
+export declare class FileWatcher extends EventEmitter {
+    private watcher;
+    private options;
+    private debounceTimers;
+    private recentUnlinks;
+    private readonly MOVE_DETECTION_WINDOW_MS;
+    constructor(options: FileWatcherOptions);
+    /**
+     * Start watching files
+     */
+    start(): void;
+    /**
+     * Stop watching files
+     */
+    stop(): Promise<void>;
+    /**
+     * Handle file system events with debouncing and move detection
+     */
+    private handleFileEvent;
+    /**
+     * Detect if a newly added file is actually a moved file
+     */
+    private detectMoveSource;
+    /**
+     * Clean up old unlink entries that have expired
+     */
+    private cleanupOldUnlinks;
+    /**
+     * Get current watch statistics
+     */
+    getStats(): {
+        watching: boolean;
+        filesWatched: number;
+        watchedPaths: string[];
+        ignoredPatterns: string[];
+    };
+    /**
+     * Check if a file is being watched
+     */
+    isWatching(filePath: string): boolean;
+}
+//# sourceMappingURL=file-watcher.d.ts.map

package/dist/sync/file-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-watcher.d.ts","sourceRoot":"","sources":["../../src/sync/file-watcher.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAGtC,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,WAAY,SAAQ,YAAY;IAC3C,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,cAAc,CAA0C;IAGhE,OAAO,CAAC,aAAa,CAAyF;IAC9G,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAQ;gBAErC,OAAO,EAAE,kBAAkB;IAQvC;;OAEG;IACH,KAAK,IAAI,IAAI;IAuCb;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB3B;;OAEG;IACH,OAAO,CAAC,eAAe;IAkFvB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAwBxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAezB;;OAEG;IACH,QAAQ,IAAI;QACV,QAAQ,EAAE,OAAO,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,eAAe,EAAE,MAAM,EAAE,CAAC;KAC3B;IAmCD;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;CAmBtC"}

package/dist/sync/file-watcher.js

@@ -0,0 +1,228 @@
+/**
+ * Waymaker Sync - File Watcher
+ * Monitors markdown files for changes and emits events
+ */
+import chokidar from 'chokidar';
+import * as path from 'path';
+import { EventEmitter } from 'events';
+export class FileWatcher extends EventEmitter {
+    watcher = null;
+    options;
+    debounceTimers = new Map();
+    // Move detection: track recently unlinked files
+    recentUnlinks = new Map();
+    MOVE_DETECTION_WINDOW_MS = 2000; // 2 second window to detect moves
+    constructor(options) {
+        super();
+        this.options = {
+            debounceMs: 1000, // Default 1 second debounce
+            ...options,
+        };
+    }
+    /**
+     * Start watching files
+     */
+    start() {
+        if (this.watcher) {
+            throw new Error('File watcher is already running');
+        }
+        // Convert watch patterns to absolute paths
+        const watchPaths = this.options.watchPatterns.map(pattern => {
+            return path.join(this.options.projectPath, pattern);
+        });
+        console.error('[FileWatcher] Starting watcher for patterns:', watchPaths);
+        console.error('[FileWatcher] Ignoring patterns:', this.options.ignorePatterns);
+        // Create watcher
+        this.watcher = chokidar.watch(watchPaths, {
+            ignored: this.options.ignorePatterns,
+            persistent: true,
+            ignoreInitial: false, // Emit events for existing files on startup
+            awaitWriteFinish: {
+                stabilityThreshold: 300,
+                pollInterval: 100,
+            },
+        });
+        // Set up event handlers
+        this.watcher
+            .on('add', (filePath) => this.handleFileEvent('add', filePath))
+            .on('change', (filePath) => this.handleFileEvent('change', filePath))
+            .on('unlink', (filePath) => this.handleFileEvent('unlink', filePath))
+            .on('error', (error) => {
+            console.error('[FileWatcher] Error:', error);
+            this.emit('error', error);
+        })
+            .on('ready', () => {
+            console.error('[FileWatcher] Initial scan complete, watching for changes...');
+            this.emit('ready');
+        });
+    }
+    /**
+     * Stop watching files
+     */
+    async stop() {
+        if (!this.watcher) {
+            return;
+        }
+        // Clear all debounce timers
+        this.debounceTimers.forEach(timer => clearTimeout(timer));
+        this.debounceTimers.clear();
+        // Close watcher
+        await this.watcher.close();
+        this.watcher = null;
+        console.error('[FileWatcher] Stopped watching files');
+    }
+    /**
+     * Handle file system events with debouncing and move detection
+     */
+    handleFileEvent(type, filePath) {
+        // Only watch .md files
+        if (!filePath.endsWith('.md')) {
+            return;
+        }
+        // Convert to relative path
+        const relativePath = path.relative(this.options.projectPath, filePath);
+        const fileName = path.basename(filePath);
+        // Clean up old unlink entries
+        this.cleanupOldUnlinks();
+        // Debounce events (prevent multiple rapid fire events)
+        const existingTimer = this.debounceTimers.get(filePath);
+        if (existingTimer) {
+            clearTimeout(existingTimer);
+        }
+        const timer = setTimeout(() => {
+            this.debounceTimers.delete(filePath);
+            // Handle unlink: store for move detection
+            if (type === 'unlink') {
+                this.recentUnlinks.set(fileName, {
+                    checksum: '', // Can't calculate - file is gone
+                    timestamp: Date.now(),
+                    absolutePath: filePath,
+                });
+                const event = {
+                    type,
+                    path: relativePath,
+                    timestamp: new Date(),
+                };
+                console.error(`[FileWatcher] ${type.toUpperCase()}: ${relativePath}`);
+                this.emit('change', event);
+                return;
+            }
+            // Handle add: check if this might be a move
+            if (type === 'add') {
+                const movedFrom = this.detectMoveSource(fileName, filePath);
+                if (movedFrom) {
+                    const oldRelativePath = path.relative(this.options.projectPath, movedFrom.absolutePath);
+                    // This is a move! Emit move event instead of add
+                    const event = {
+                        type: 'move',
+                        path: relativePath,
+                        oldPath: oldRelativePath,
+                        timestamp: new Date(),
+                    };
+                    console.error(`[FileWatcher] MOVE: ${oldRelativePath} → ${relativePath}`);
+                    this.emit('change', event);
+                    // Remove from recent unlinks
+                    this.recentUnlinks.delete(fileName);
+                    return;
+                }
+            }
+            // Default: emit the event as-is
+            const event = {
+                type,
+                path: relativePath,
+                timestamp: new Date(),
+            };
+            console.error(`[FileWatcher] ${type.toUpperCase()}: ${relativePath}`);
+            this.emit('change', event);
+        }, this.options.debounceMs);
+        this.debounceTimers.set(filePath, timer);
+    }
+    /**
+     * Detect if a newly added file is actually a moved file
+     */
+    detectMoveSource(fileName, newFilePath) {
+        const unlinked = this.recentUnlinks.get(fileName);
+        if (!unlinked) {
+            return null;
+        }
+        // Check if within move detection window
+        const elapsed = Date.now() - unlinked.timestamp;
+        if (elapsed > this.MOVE_DETECTION_WINDOW_MS) {
+            return null;
+        }
+        // Make sure it's not the same path (not a move)
+        if (unlinked.absolutePath === newFilePath) {
+            return null;
+        }
+        return unlinked;
+    }
+    /**
+     * Clean up old unlink entries that have expired
+     */
+    cleanupOldUnlinks() {
+        const now = Date.now();
+        const expiredKeys = [];
+        for (const [fileName, entry] of this.recentUnlinks) {
+            if (now - entry.timestamp > this.MOVE_DETECTION_WINDOW_MS * 2) {
+                expiredKeys.push(fileName);
+            }
+        }
+        for (const key of expiredKeys) {
+            this.recentUnlinks.delete(key);
+        }
+    }
+    /**
+     * Get current watch statistics
+     */
+    getStats() {
+        if (!this.watcher) {
+            return {
+                watching: false,
+                filesWatched: 0,
+                watchedPaths: [],
+                ignoredPatterns: this.options.ignorePatterns,
+            };
+        }
+        // Get actual watched files from chokidar
+        const watched = this.watcher.getWatched();
+        let filesWatched = 0;
+        const watchedPaths = [];
+        for (const [dir, files] of Object.entries(watched)) {
+            if (Array.isArray(files)) {
+                for (const file of files) {
+                    // Only count .md files
+                    if (file.endsWith('.md')) {
+                        watchedPaths.push(path.join(dir, file));
+                        filesWatched++;
+                    }
+                }
+            }
+        }
+        return {
+            watching: true,
+            filesWatched,
+            watchedPaths,
+            ignoredPatterns: this.options.ignorePatterns,
+        };
+    }
+    /**
+     * Check if a file is being watched
+     */
+    isWatching(filePath) {
+        if (!this.watcher) {
+            return false;
+        }
+        const absolutePath = path.resolve(this.options.projectPath, filePath);
+        const watchedPaths = this.watcher.getWatched();
+        // Check if file's directory is in watched paths
+        const dir = path.dirname(absolutePath);
+        const fileName = path.basename(absolutePath);
+        return Object.keys(watchedPaths).some(watchedDir => {
+            if (dir === watchedDir) {
+                return watchedPaths[watchedDir].includes(fileName);
+            }
+            return false;
+        });
+    }
+}
+//# sourceMappingURL=file-watcher.js.map

package/dist/sync/file-watcher.js.map

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

package/dist/sync/folder-service.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Waymaker Sync - Folder Service
+ * Auto-creates folder hierarchy to mirror IDE structure in Commander
+ */
+import { CommanderClient } from './commander-client.js';
+export interface CommanderFolder {
+    id: string;
+    name: string;
+    project_id: string;
+    workspace_id: string;
+    parent_folder_id: string | null;
+    created_by: string;
+    created_at: string;
+    updated_at: string;
+    sort_order: number;
+    deleted_at: string | null;
+}
+export interface FolderServiceConfig {
+    projectId: string;
+    workspaceId: string;
+    organizationId: string;
+    userId: string;
+    projectRoot: string;
+}
+/**
+ * FolderService - Manages folder hierarchy syncing from IDE to Commander
+ *
+ * Responsibilities:
+ * 1. Parse file paths into folder hierarchy
+ * 2. Create missing folders in Commander
+ * 3. Cache folder lookups to avoid duplicates
+ * 4. Return folder_id for document assignment
+ *
+ * Example:
+ * File path: /Users/name/Projects/waymaker/docs/01-planning/features/api-keys.md
+ * Project root: /Users/name/Projects/waymaker
+ * Relative path: docs/01-planning/features/api-keys.md
+ * Folder hierarchy: docs → 01-planning → features
+ */
+export declare class FolderService {
+    private client;
+    private config;
+    private folderCache;
+    private initialized;
+    private initializationPromise;
+    constructor(config: FolderServiceConfig, client?: CommanderClient);
+    /**
+     * Initialize folder cache by loading all existing folders from Commander
+     * Call this once before starting sync operations
+     * Uses promise lock to prevent concurrent initialization
+     */
+    initialize(): Promise<void>;
+    /**
+     * Ensure folder hierarchy exists for a file path
+     * Returns folder_id for the deepest folder (to assign to document)
+     *
+     * Example:
+     * Input: /Users/name/Projects/waymaker/docs/01-planning/features/api-keys.md
+     * Output: folder_id for "features" folder
+     * Side effect: Creates "docs", "01-planning", "features" if they don't exist
+     */
+    ensureFolderHierarchy(absoluteFilePath: string): Promise<string | null>;
+    /**
+     * Create a single folder in Commander with retry logic for race conditions
+     * If folder creation fails due to unique constraint, fetch the existing folder
+     */
+    private createFolderWithRetry;
+    /**
+     * List all folders for the project
+     */
+    private listAllFolders;
+    /**
+     * Build full folder path from folder ID by traversing parent hierarchy
+     */
+    private buildFolderPath;
+    /**
+     * Get relative path from project root
+     * Example:
+     * Absolute: /Users/name/Projects/waymaker/docs/file.md
+     * Root: /Users/name/Projects/waymaker
+     * Relative: docs/file.md
+     */
+    private getRelativePath;
+    /**
+     * Ensure a folder path exists (for empty folder sync)
+     * Unlike ensureFolderHierarchy which takes a file path, this takes a folder path directly
+     *
+     * Example:
+     * Input: "docs/05-reference/api" (relative to project root)
+     * Output: folder_id for "api" folder
+     * Side effect: Creates "docs", "05-reference", "api" if they don't exist
+     */
+    ensureFolderPath(relativeFolderPath: string): Promise<string | null>;
+    /**
+     * Clear cache (useful for testing or when folders are modified externally)
+     */
+    clearCache(): void;
+    /**
+     * Get folder by path (for testing/debugging)
+     */
+    getFolderByPath(folderPath: string): CommanderFolder | undefined;
+    /**
+     * Get cache statistics (for debugging)
+     */
+    getCacheStats(): {
+        size: number;
+        paths: string[];
+    };
+}
+//# sourceMappingURL=folder-service.d.ts.map

package/dist/sync/folder-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"folder-service.d.ts","sourceRoot":"","sources":["../../src/sync/folder-service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGxD,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,WAAW,CAA+B;IAClD,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,qBAAqB,CAA8B;gBAE/C,MAAM,EAAE,mBAAmB,EAAE,MAAM,CAAC,EAAE,eAAe;IAMjE;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA2CjC;;;;;;;;OAQG;IACG,qBAAqB,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IA0D7E;;;OAGG;YACW,qBAAqB;IA0DnC;;OAEG;YACW,cAAc;IAW5B;;OAEG;IACH,OAAO,CAAC,eAAe;IAgBvB;;;;;;OAMG;IACH,OAAO,CAAC,eAAe;IAiBvB;;;;;;;;OAQG;IACG,gBAAgB,CAAC,kBAAkB,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAkD1E;;OAEG;IACH,UAAU,IAAI,IAAI;IAOlB;;OAEG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAIhE;;OAEG;IACH,aAAa,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE;CAMnD"}