@n8n-as-code/core 0.2.0 → 0.3.1

package/dist/services/state-manager.js

@@ -1,11 +1,23 @@
 import fs from 'fs';
 import path from 'path';
-import crypto from 'crypto';
+/**
+ * Read-only State Manager
+ *
+ * Responsibilities:
+ * 1. Read state from .n8n-state.json
+ * 2. Provide read-only access to workflow states
+ *
+ * Note: Write operations are handled exclusively by Watcher component
+ * to maintain single source of truth for state mutations.
+ */
 export class StateManager {
     stateFilePath;
     constructor(directory) {
         this.stateFilePath = path.join(directory, '.n8n-state.json');
     }
+    /**
+     * Load state from disk (private method)
+     */
     load() {
         if (fs.existsSync(this.stateFilePath)) {
             try {
@@ -22,44 +34,13 @@ export class StateManager {
         }
         return { workflows: {} };
     }
-    save(state) {
-        fs.writeFileSync(this.stateFilePath, JSON.stringify(state, null, 2));
-    }
     /**
-     * Computes a stable hash for a workflow object.
-     */
-    static computeHash(workflow) {
-        // We use the cleaned version to ensure stable hashing (no dynamic IDs or timestamps)
-        const content = typeof workflow === 'string' ? workflow : JSON.stringify(workflow);
-        return crypto.createHash('sha256').update(content).digest('hex');
-    }
-    /**
-     * Gets the last known state for a workflow.
+     * Gets the last known state (Base) for a workflow.
      */
     getWorkflowState(id) {
         const state = this.load();
         return state.workflows[id];
     }
-    /**
-     * Updates the last known state for a workflow.
-     */
-    updateWorkflowState(id, workflow) {
-        const state = this.load();
-        const hash = StateManager.computeHash(workflow);
-        state.workflows[id] = {
-            lastSyncedHash: hash,
-            lastSyncedAt: new Date().toISOString()
-        };
-        this.save(state);
-    }
-    /**
-     * Removes a workflow from state.
-     */
-    removeWorkflowState(id) {
-        const state = this.load();
-        delete state.workflows[id];
-        this.save(state);
-    }
     /**
      * Gets all tracked workflow IDs.
      */
@@ -68,32 +49,20 @@ export class StateManager {
         return Object.keys(state.workflows);
     }
     /**
-     * Checks if a local content matches the last synced state.
+     * Checks if a hash matches the last synced state.
      */
-    isLocalSynced(id, localContent) {
+    isSynced(id, currentHash) {
         const state = this.getWorkflowState(id);
         if (!state)
-            return true; // If no state, we assume it's new
-        const currentHash = StateManager.computeHash(localContent);
-        const result = state.lastSyncedHash === currentHash;
-        if (!result) {
-            // Changed from console.log to silent for production
-        }
-        return result;
+            return false;
+        return state.lastSyncedHash === currentHash;
     }
     /**
-     * Checks if a remote workflow matches the last synced state.
+     * Get the entire state object (for Watcher's internal use)
+     * @internal
      */
-    isRemoteSynced(id, remoteWorkflow) {
-        const state = this.getWorkflowState(id);
-        if (!state)
-            return true;
-        const remoteHash = StateManager.computeHash(remoteWorkflow);
-        const result = state.lastSyncedHash === remoteHash;
-        if (!result) {
-            // Changed from console.log to silent for production
-        }
-        return result;
+    getFullState() {
+        return this.load();
     }
 }
 //# sourceMappingURL=state-manager.js.map

package/dist/services/state-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"state-manager.js","sourceRoot":"","sources":["../../src/services/state-manager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"state-manager.js","sourceRoot":"","sources":["../../src/services/state-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAYxB;;;;;;;;;GASG;AACH,MAAM,OAAO,YAAY;IACb,aAAa,CAAS;IAE9B,YAAY,SAAiB;QACzB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC;IACjE,CAAC;IAED;;OAEG;IACK,IAAI;QACR,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;YACpC,IAAI,CAAC;gBACD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC;gBACtE,iCAAiC;gBACjC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;oBAClB,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;gBACxB,CAAC;gBACD,OAAO,IAAI,CAAC;YAChB,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACT,OAAO,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;YACjE,CAAC;QACL,CAAC;QACD,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,EAAU;QACvB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,qBAAqB;QACjB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC1B,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,EAAU,EAAE,WAAmB;QACpC,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;QACxC,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;QACzB,OAAO,KAAK,CAAC,cAAc,KAAK,WAAW,CAAC;IAChD,CAAC;IAED;;;OAGG;IACH,YAAY;QACR,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;CACJ"}

package/dist/services/sync-engine.d.ts

@@ -0,0 +1,57 @@
+import { N8nApiClient } from './n8n-api-client.js';
+import { Watcher } from './watcher.js';
+import { WorkflowSyncStatus } from '../types.js';
+/**
+ * Sync Engine - State Mutation Component
+ *
+ * Responsibilities:
+ * 1. Execute PULL/PUSH operations based on status
+ * 2. Follow strategy tables from SPECS/REFACTO_CORE.md
+ * 3. Call Watcher.finalizeSync after successful operations
+ * 4. Handle archive operations
+ *
+ * Stateless regarding history - never writes to state file directly
+ */
+export declare class SyncEngine {
+    private client;
+    private watcher;
+    private directory;
+    private archiveDirectory;
+    constructor(client: N8nApiClient, watcher: Watcher, directory: string);
+    /**
+     * PULL Strategy: Remote -> Local
+     * Based on spec 5.2 PULL Strategy table
+     */
+    pull(workflowId: string, filename: string, status: WorkflowSyncStatus): Promise<void>;
+    /**
+     * PUSH Strategy: Local -> Remote
+     * Based on spec 5.3 PUSH Strategy table
+     */
+    push(filename: string, workflowId?: string, status?: WorkflowSyncStatus): Promise<string>;
+    /**
+     * Force PULL - overwrite local with remote (for conflict resolution)
+     */
+    forcePull(workflowId: string, filename: string): Promise<void>;
+    /**
+     * Force PUSH - overwrite remote with local (for conflict resolution and restoration)
+     * If workflow doesn't exist on remote, creates it
+     */
+    forcePush(workflowId: string, filename: string): Promise<string>;
+    /**
+     * Delete remote workflow (for deletion validation)
+     * Note: The Watcher already archived the remote content when it detected the local deletion
+     */
+    deleteRemote(workflowId: string, filename: string): Promise<void>;
+    /**
+     * Restore from archive (for deletion validation)
+     * Moves the file from archive back to workflows directory
+     * Then DELETES the archive file (no need to keep it after restoration)
+     */
+    restoreFromArchive(filename: string): Promise<boolean>;
+    private executePull;
+    private executeUpdate;
+    private executeCreate;
+    archive(filename: string): Promise<void>;
+    private readJsonFile;
+}
+//# sourceMappingURL=sync-engine.d.ts.map

package/dist/services/sync-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-engine.d.ts","sourceRoot":"","sources":["../../src/services/sync-engine.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAAa,MAAM,aAAa,CAAC;AAE5D;;;;;;;;;;GAUG;AACH,qBAAa,UAAU;IACnB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,gBAAgB,CAAS;gBAG7B,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,MAAM;IAYrB;;;OAGG;IACU,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAoDlG;;;OAGG;IACU,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;IAuDtG;;OAEG;IACU,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa3E;;;OAGG;IACU,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAkC7E;;;OAGG;IACU,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB9E;;;;OAIG;IACU,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;YAyBrD,WAAW;YAwBX,aAAa;YAwBb,aAAa;IAwBd,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQrD,OAAO,CAAC,YAAY;CAOvB"}

package/dist/services/sync-engine.js

@@ -0,0 +1,301 @@
+import fs from 'fs';
+import path from 'path';
+import { WorkflowSanitizer } from './workflow-sanitizer.js';
+import { HashUtils } from './hash-utils.js';
+import { WorkflowSyncStatus } from '../types.js';
+/**
+ * Sync Engine - State Mutation Component
+ *
+ * Responsibilities:
+ * 1. Execute PULL/PUSH operations based on status
+ * 2. Follow strategy tables from SPECS/REFACTO_CORE.md
+ * 3. Call Watcher.finalizeSync after successful operations
+ * 4. Handle archive operations
+ *
+ * Stateless regarding history - never writes to state file directly
+ */
+export class SyncEngine {
+    client;
+    watcher;
+    directory;
+    archiveDirectory;
+    constructor(client, watcher, directory) {
+        this.client = client;
+        this.watcher = watcher;
+        this.directory = directory;
+        this.archiveDirectory = path.join(directory, '.archive');
+        if (!fs.existsSync(this.archiveDirectory)) {
+            fs.mkdirSync(this.archiveDirectory, { recursive: true });
+        }
+    }
+    /**
+     * PULL Strategy: Remote -> Local
+     * Based on spec 5.2 PULL Strategy table
+     */
+    async pull(workflowId, filename, status) {
+        // Mark sync in progress to prevent race conditions
+        this.watcher.markSyncInProgress(workflowId);
+        this.watcher.pauseObservation(workflowId);
+        try {
+            switch (status) {
+                case WorkflowSyncStatus.EXIST_ONLY_REMOTELY:
+                    // Download Remote JSON -> Write to disk
+                    await this.executePull(workflowId, filename);
+                    // Initialize lastSyncedHash via finalizeSync
+                    await this.watcher.finalizeSync(workflowId);
+                    break;
+                case WorkflowSyncStatus.MODIFIED_REMOTELY:
+                    // Download Remote JSON -> Overwrite local file
+                    await this.executePull(workflowId, filename);
+                    // Update lastSyncedHash via finalizeSync
+                    await this.watcher.finalizeSync(workflowId);
+                    break;
+                case WorkflowSyncStatus.DELETED_REMOTELY:
+                    // Move local file to archive
+                    await this.archive(filename);
+                    // Remove from state (handled by watcher after observation resumes)
+                    // Watcher will detect file deletion and update status
+                    break;
+                case WorkflowSyncStatus.CONFLICT:
+                    // Halt - trigger conflict resolution
+                    throw new Error(`Conflict detected for workflow ${workflowId}. Use resolveConflict instead.`);
+                case WorkflowSyncStatus.DELETED_LOCALLY:
+                    // No action per spec
+                    break;
+                case WorkflowSyncStatus.EXIST_ONLY_LOCALLY:
+                case WorkflowSyncStatus.IN_SYNC:
+                case WorkflowSyncStatus.MODIFIED_LOCALLY:
+                    // No action per spec
+                    break;
+                default:
+                    console.warn(`[SyncEngine] Unhandled status ${status} for PULL operation`);
+                    break;
+            }
+        }
+        finally {
+            this.watcher.markSyncComplete(workflowId);
+            this.watcher.resumeObservation(workflowId);
+        }
+    }
+    /**
+     * PUSH Strategy: Local -> Remote
+     * Based on spec 5.3 PUSH Strategy table
+     */
+    async push(filename, workflowId, status) {
+        if (workflowId) {
+            this.watcher.markSyncInProgress(workflowId);
+            this.watcher.pauseObservation(workflowId);
+        }
+        try {
+            // If no workflowId, treat as EXIST_ONLY_LOCALLY
+            if (!workflowId || status === WorkflowSyncStatus.EXIST_ONLY_LOCALLY) {
+                // POST to API (Create)
+                const newWorkflowId = await this.executeCreate(filename);
+                // Initialize lastSyncedHash via finalizeSync
+                await this.watcher.finalizeSync(newWorkflowId);
+                return newWorkflowId;
+            }
+            // With workflowId and status
+            switch (status) {
+                case WorkflowSyncStatus.MODIFIED_LOCALLY:
+                    // PUT to API (Update)
+                    await this.executeUpdate(workflowId, filename);
+                    // Update lastSyncedHash via finalizeSync
+                    await this.watcher.finalizeSync(workflowId);
+                    return workflowId;
+                case WorkflowSyncStatus.DELETED_LOCALLY:
+                    // Step 1: Archive Remote to _archive/
+                    await this.archive(filename);
+                    // Step 2: Trigger Deletion Validation (caller should handle)
+                    // Note: Actual API deletion happens in ResolutionManager
+                    throw new Error(`Local deletion detected for workflow ${workflowId}. Use confirmDeletion instead.`);
+                case WorkflowSyncStatus.CONFLICT:
+                    // Halt - trigger conflict resolution
+                    throw new Error(`Conflict detected for workflow ${workflowId}. Use resolveConflict instead.`);
+                case WorkflowSyncStatus.EXIST_ONLY_REMOTELY:
+                case WorkflowSyncStatus.IN_SYNC:
+                case WorkflowSyncStatus.MODIFIED_REMOTELY:
+                case WorkflowSyncStatus.DELETED_REMOTELY:
+                    // No action per spec
+                    return workflowId;
+                default:
+                    console.warn(`[SyncEngine] Unhandled status ${status} for PUSH operation`);
+                    return workflowId;
+            }
+        }
+        finally {
+            if (workflowId) {
+                this.watcher.markSyncComplete(workflowId);
+                this.watcher.resumeObservation(workflowId);
+            }
+        }
+    }
+    /**
+     * Force PULL - overwrite local with remote (for conflict resolution)
+     */
+    async forcePull(workflowId, filename) {
+        this.watcher.markSyncInProgress(workflowId);
+        this.watcher.pauseObservation(workflowId);
+        try {
+            await this.executePull(workflowId, filename);
+            await this.watcher.finalizeSync(workflowId);
+        }
+        finally {
+            this.watcher.markSyncComplete(workflowId);
+            this.watcher.resumeObservation(workflowId);
+        }
+    }
+    /**
+     * Force PUSH - overwrite remote with local (for conflict resolution and restoration)
+     * If workflow doesn't exist on remote, creates it
+     */
+    async forcePush(workflowId, filename) {
+        this.watcher.markSyncInProgress(workflowId);
+        this.watcher.pauseObservation(workflowId);
+        let finalWorkflowId = workflowId;
+        try {
+            // Try to update first
+            try {
+                await this.executeUpdate(workflowId, filename);
+            }
+            catch (error) {
+                // If update fails with 404, create the workflow instead
+                if (error.response?.status === 404 || error.message?.includes('404') || error.message?.includes('Not Found')) {
+                    console.log(`[SyncEngine] Workflow ${workflowId} not found, creating new workflow`);
+                    const newWorkflowId = await this.executeCreate(filename);
+                    // Migrate state from old ID to new ID
+                    if (newWorkflowId !== workflowId) {
+                        await this.watcher.updateWorkflowId(workflowId, newWorkflowId);
+                        finalWorkflowId = newWorkflowId;
+                    }
+                }
+                else {
+                    throw error;
+                }
+            }
+            await this.watcher.finalizeSync(finalWorkflowId);
+            return finalWorkflowId;
+        }
+        finally {
+            this.watcher.markSyncComplete(finalWorkflowId);
+            this.watcher.resumeObservation(finalWorkflowId);
+        }
+    }
+    /**
+     * Delete remote workflow (for deletion validation)
+     * Note: The Watcher already archived the remote content when it detected the local deletion
+     */
+    async deleteRemote(workflowId, filename) {
+        this.watcher.markSyncInProgress(workflowId);
+        this.watcher.pauseObservation(workflowId);
+        try {
+            // Delete from API
+            await this.client.deleteWorkflow(workflowId);
+            // Archive local file if it still exists (edge case - shouldn't happen for DELETED_LOCALLY)
+            await this.archive(filename);
+            // Note: State removal will be handled by caller (ResolutionManager)
+        }
+        finally {
+            this.watcher.markSyncComplete(workflowId);
+            this.watcher.resumeObservation(workflowId);
+        }
+    }
+    /**
+     * Restore from archive (for deletion validation)
+     * Moves the file from archive back to workflows directory
+     * Then DELETES the archive file (no need to keep it after restoration)
+     */
+    async restoreFromArchive(filename) {
+        const archiveFiles = fs.readdirSync(this.archiveDirectory);
+        const matchingArchives = archiveFiles.filter(f => f.includes(filename));
+        if (matchingArchives.length === 0) {
+            return false;
+        }
+        // Get most recent archive
+        const mostRecent = matchingArchives.sort().reverse()[0];
+        const archivePath = path.join(this.archiveDirectory, mostRecent);
+        const targetPath = path.join(this.directory, filename);
+        // Read content from archive
+        const content = fs.readFileSync(archivePath, 'utf-8');
+        // Write to target location
+        fs.writeFileSync(targetPath, content);
+        // Delete the archive file (no need to keep it after restoration)
+        fs.unlinkSync(archivePath);
+        return true;
+    }
+    async executePull(workflowId, filename) {
+        const fullWf = await this.client.getWorkflow(workflowId);
+        if (!fullWf) {
+            // Workflow might have been deleted (DELETED_REMOTELY case)
+            // Check if local file exists - if so, archive it
+            const filePath = path.join(this.directory, filename);
+            if (fs.existsSync(filePath)) {
+                await this.archive(filename);
+                // Don't throw - archiving is the expected behavior for DELETED_REMOTELY
+                return;
+            }
+            throw new Error(`Remote workflow ${workflowId} not found during pull`);
+        }
+        const clean = WorkflowSanitizer.cleanForStorage(fullWf);
+        const filePath = path.join(this.directory, filename);
+        fs.writeFileSync(filePath, JSON.stringify(clean, null, 2));
+        // Update Watcher's remote hash cache since we just fetched the workflow
+        // This ensures finalizeSync has the remote hash
+        const hash = HashUtils.computeHash(clean);
+        this.watcher.setRemoteHash(workflowId, hash);
+    }
+    async executeUpdate(workflowId, filename) {
+        const filePath = path.join(this.directory, filename);
+        const localWf = this.readJsonFile(filePath);
+        if (!localWf) {
+            throw new Error('Local file not found during push');
+        }
+        const payload = WorkflowSanitizer.cleanForPush(localWf);
+        const updatedWf = await this.client.updateWorkflow(workflowId, payload);
+        if (!updatedWf) {
+            throw new Error('Failed to update remote workflow');
+        }
+        // CRITICAL: Write the API response back to local file to ensure consistency
+        // This ensures local and remote have identical content after push
+        const clean = WorkflowSanitizer.cleanForStorage(updatedWf);
+        fs.writeFileSync(filePath, JSON.stringify(clean, null, 2));
+        // Update Watcher's remote hash cache with the updated workflow
+        const hash = HashUtils.computeHash(clean);
+        this.watcher.setRemoteHash(workflowId, hash);
+    }
+    async executeCreate(filename) {
+        const filePath = path.join(this.directory, filename);
+        const localWf = this.readJsonFile(filePath);
+        if (!localWf) {
+            throw new Error('Local file not found during creation');
+        }
+        const payload = WorkflowSanitizer.cleanForPush(localWf);
+        if (!payload.name) {
+            payload.name = path.parse(filename).name;
+        }
+        const newWf = await this.client.createWorkflow(payload);
+        if (!newWf || !newWf.id) {
+            throw new Error('Failed to create remote workflow');
+        }
+        // Update local file with new ID
+        localWf.id = newWf.id;
+        fs.writeFileSync(filePath, JSON.stringify(localWf, null, 2));
+        return newWf.id;
+    }
+    async archive(filename) {
+        const filePath = path.join(this.directory, filename);
+        if (fs.existsSync(filePath)) {
+            const archivePath = path.join(this.archiveDirectory, `${Date.now()}_${filename}`);
+            fs.renameSync(filePath, archivePath);
+        }
+    }
+    readJsonFile(filePath) {
+        try {
+            return JSON.parse(fs.readFileSync(filePath, 'utf8'));
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=sync-engine.js.map

package/dist/services/sync-engine.js.map

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

package/dist/services/sync-manager.d.ts

@@ -4,98 +4,34 @@ import { ISyncConfig, IWorkflowStatus } from '../types.js';
 export declare class SyncManager extends EventEmitter {
     private client;
     private config;
-    private fileToIdMap;
-    private selfWrittenCache;
-    private isWriting;
-    private pendingDeletions;
-    private watcher;
-    private pollInterval;
     private stateManager;
-    private trashService;
+    private watcher;
+    private syncEngine;
+    private resolutionManager;
     constructor(client: N8nApiClient, config: ISyncConfig);
-    /**
-     * Get the path to the instance configuration file
-     */
-    private getInstanceConfigPath;
-    /**
-     * Load instance configuration from disk
-     */
-    private loadInstanceConfig;
-    /**
-     * Save instance configuration to disk
-     */
-    private saveInstanceConfig;
-    /**
-     * Ensure instance identifier is set and persistent
-     */
-    private ensureInstanceIdentifier;
-    private initializeInstanceIdentifier;
-    getInstanceDirectory(): string;
-    private getFilePath;
-    private safeName;
-    private normalizeContent;
-    private markAsSelfWritten;
-    private isSelfWritten;
-    loadRemoteState(): Promise<void>;
-    /**
-     * Retrieves the status of all workflows (local and remote)
-     */
+    private ensureInitialized;
     getWorkflowsStatus(): Promise<IWorkflowStatus[]>;
-    private formatSummary;
-    /**
-     * Scans n8n instance and updates local files (Downstream Sync)
-     */
     syncDown(): Promise<void>;
-    /**
-     * Identifies and handles workflows deleted on n8n but still present locally and tracked in state
-     */
-    private processRemoteDeletions;
-    /**
-     * Scans n8n instance and updates local files with conflict resolution
-     */
-    syncDownWithConflictResolution(): Promise<void>;
-    /**
-     * Pulls a single workflow by ID and writes to filename
-     * @param force If true, overwrites local changes without checking for conflicts
-     */
-    pullWorkflow(filename: string, id: string, force?: boolean): Promise<void>;
-    /**
-     * Pulls a single workflow with conflict resolution
-     * @returns 'updated' if file was updated, 'skipped' if no change or conflict, 'new' if file was created
-     */
-    pullWorkflowWithConflictResolution(filename: string, id: string, remoteUpdatedAt?: string): Promise<'updated' | 'skipped' | 'new' | 'up-to-date' | 'conflict'>;
-    /**
-     * Writes file to disk only if changed
-     */
-    private writeLocalFile;
-    private shouldIgnore;
-    /**
-     * Uploads local files that don't exist remotely (Upstream Sync - Init)
-     */
-    syncUpMissing(): Promise<void>;
-    /**
-     * Full Upstream Sync: Updates existing and Creates new.
-     */
     syncUp(): Promise<void>;
+    startWatch(): Promise<void>;
     /**
-     * Handles local file deletion (detected by watcher)
-     */
-    handleLocalFileDeletion(filePath: string): Promise<void>;
-    /**
-     * Actually deletes the remote workflow and cleans up local state
-     */
-    deleteRemoteWorkflow(id: string, filename: string): Promise<boolean>;
-    /**
-     * Restore a deleted local file from remote
+     * Create or update the n8n-as-code-instance.json file
+     * This file marks the workspace as initialized and stores the instance identifier
      */
-    restoreLocalFile(id: string, filename: string): Promise<boolean>;
+    private ensureInstanceConfigFile;
     /**
-     * Handle FS watcher events
+     * Handle automatic synchronization based on status changes
+     * Only triggered in auto mode
      */
-    handleLocalFileChange(filePath: string, silent?: boolean): Promise<'updated' | 'created' | 'up-to-date' | 'conflict' | 'skipped'>;
-    private readLocalFile;
-    private readRawFile;
-    startWatch(): Promise<void>;
+    private handleAutoSync;
     stopWatch(): void;
+    refreshState(): Promise<void>;
+    getInstanceDirectory(): string;
+    resolveConflict(id: string, filename: string, choice: 'local' | 'remote'): Promise<void>;
+    handleLocalFileChange(filePath: string): Promise<'updated' | 'created' | 'up-to-date' | 'conflict' | 'skipped'>;
+    restoreLocalFile(id: string, filename: string): Promise<boolean>;
+    deleteRemoteWorkflow(id: string, filename: string): Promise<boolean>;
+    confirmDeletion(id: string, filename: string): Promise<void>;
+    restoreRemoteWorkflow(id: string, filename: string): Promise<string>;
 }
 //# sourceMappingURL=sync-manager.d.ts.map

package/dist/services/sync-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sync-manager.d.ts","sourceRoot":"","sources":["../../src/services/sync-manager.ts"],"names":[],"mappings":"AAEA,OAAO,YAAY,MAAM,QAAQ,CAAC;AAGlC,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAKnD,OAAO,EAAE,WAAW,EAAiC,eAAe,EAAE,MAAM,aAAa,CAAC;AAO1F,qBAAa,WAAY,SAAQ,YAAY;IACzC,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,MAAM,CAAc;IAG5B,OAAO,CAAC,WAAW,CAAkC;IAErD,OAAO,CAAC,gBAAgB,CAAkC;IAE1D,OAAO,CAAC,SAAS,CAAqB;IAEtC,OAAO,CAAC,gBAAgB,CAAqB;IAE7C,OAAO,CAAC,OAAO,CAAmC;IAClD,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,YAAY,CAA6B;gBAErC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW;IAWrD;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAI7B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAa1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAK1B;;OAEG;YACW,wBAAwB;YA+BxB,4BAA4B;IAkBnC,oBAAoB,IAAI,MAAM;IAarC,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,aAAa;IAOf,eAAe;IAarB;;OAEG;IACG,kBAAkB,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IA8DtD,OAAO,CAAC,aAAa;IASrB;;OAEG;IACG,QAAQ;IAmCd;;OAEG;YACW,sBAAsB;IAoCpC;;OAEG;IACG,8BAA8B;IAkCpC;;;OAGG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,GAAE,OAAe;IA4BvE;;;OAGG;IACG,kCAAkC,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,GAAG,KAAK,GAAG,YAAY,GAAG,UAAU,CAAC;IA8CpK;;OAEG;YACW,cAAc;IAqC5B,OAAO,CAAC,YAAY;IASpB;;OAEG;IACG,aAAa;IAenB;;OAEG;IACG,MAAM;IAqBZ;;OAEG;IACG,uBAAuB,CAAC,QAAQ,EAAE,MAAM;IAiB9C;;OAEG;IACG,oBAAoB,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAuB1E;;OAEG;IACG,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAkBtE;;OAEG;IACG,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAE,OAAe,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,GAAG,YAAY,GAAG,UAAU,GAAG,SAAS,CAAC;IA0F9I,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,WAAW;IAIb,UAAU;IAwChB,SAAS;CAWZ"}
+{"version":3,"file":"sync-manager.d.ts","sourceRoot":"","sources":["../../src/services/sync-manager.ts"],"names":[],"mappings":"AAEA,OAAO,YAAY,MAAM,QAAQ,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAKnD,OAAO,EAAE,WAAW,EAAiC,eAAe,EAAE,MAAM,aAAa,CAAC;AAE1F,qBAAa,WAAY,SAAQ,YAAY;IACzC,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,iBAAiB,CAAkC;gBAE/C,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW;YAUvC,iBAAiB;IAgEzB,kBAAkB,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAMhD,QAAQ;IAaR,MAAM;IAaN,UAAU;IAUhB;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAsBhC;;;OAGG;YACW,cAAc;IAkD5B,SAAS;IAKH,YAAY;IAOX,oBAAoB,IAAI,MAAM;IAK/B,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,QAAQ;IASxE,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,GAAG,YAAY,GAAG,UAAU,GAAG,SAAS,CAAC;IAwB/G,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAmBhE,oBAAoB,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAgBpE,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa5D,qBAAqB,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAI7E"}