nstantpage-agent 0.5.27 → 0.5.29

package/dist/agentSync.d.ts

@@ -81,5 +81,15 @@ export declare class AgentSync {
     private snapshotBaseline;
     /** Read a single file from disk (for diff view) */
     readDiskFile(filePath: string): Promise<string | null>;
+    /**
+     * Pull files from the backend DB and write them to disk.
+     * This fetches ALL project files and overwrites local versions.
+     * Files that exist only on disk (not in DB) are left untouched.
+     */
+    pullFromBackend(): Promise<{
+        success: boolean;
+        filesWritten: number;
+        versionId?: string;
+    }>;
     destroy(): void;
 }

package/dist/agentSync.js

@@ -278,6 +278,13 @@ export class AgentSync {
                 continue;
             if (SKIP_EXTENSIONS.has(ext))
                 continue;
+            // Match disk scan: skip files inside SKIP_DIRS directories
+            const parts = filePath.split('/');
+            if (parts.some(p => SKIP_DIRS.has(p)))
+                continue;
+            // Match disk scan: skip dist/ and build/ top-level paths
+            if (filePath.startsWith('dist/') || filePath.startsWith('build/'))
+                continue;
             filtered.set(filePath, sha);
         }
         return filtered;
@@ -358,36 +365,11 @@ export class AgentSync {
             }
         }
         // Determine direction
+        // Disk is always the source of truth. DB only changes via push or AI coding agent
+        // (which updates both disk+DB simultaneously). So direction is only ever
+        // 'in-sync' or 'disk-ahead'. backendOnlyFiles are stale DB remnants, not "newer" files.
         const inSync = modifiedFiles.length === 0 && diskOnlyFiles.length === 0 && backendOnlyFiles.length === 0;
-        let direction = 'in-sync';
-        if (!inSync) {
-            const hasDiskEdits = modifiedFiles.length > 0 || diskOnlyFiles.length > 0;
-            const hasBackendEdits = backendOnlyFiles.length > 0;
-            let modifiedFromBackend = false;
-            if (modifiedFiles.length > 0 && baseline) {
-                for (const filePath of modifiedFiles) {
-                    const baselineSha = baseline.get(filePath);
-                    const diskSha = diskResult.checksums.get(filePath);
-                    const backendSha = filteredBackend.get(filePath);
-                    if (baselineSha && diskSha === baselineSha && backendSha && backendSha !== baselineSha) {
-                        modifiedFromBackend = true;
-                        break;
-                    }
-                }
-            }
-            if ((hasDiskEdits && !modifiedFromBackend) && hasBackendEdits) {
-                direction = 'diverged';
-            }
-            else if (hasDiskEdits && !modifiedFromBackend && !hasBackendEdits) {
-                direction = 'disk-ahead';
-            }
-            else if (hasBackendEdits || modifiedFromBackend) {
-                direction = 'backend-ahead';
-            }
-            else {
-                direction = 'disk-ahead';
-            }
-        }
+        const direction = inSync ? 'in-sync' : 'disk-ahead';
         return {
             inSync,
             direction,
@@ -410,12 +392,14 @@ export class AgentSync {
         const backendResult = await this.fetchBackendChecksums();
         if (!backendResult)
             return [];
+        // Use filtered backend checksums (same skip rules as disk scan) for consistency with getSyncStatus
+        const filteredBackend = this.filterBackendChecksums(backendResult.checksums);
         const baseline = this.syncedBaselineChecksums;
         const result = [];
         if (baseline) {
             for (const [filePath, baselineSha] of baseline) {
                 const currentDiskSha = diskComputed.checksums.get(filePath);
-                const backendSha = backendResult.checksums.get(filePath);
+                const backendSha = filteredBackend.get(filePath);
                 if (!currentDiskSha) {
                     if (backendSha) {
                         result.push({ path: filePath, status: 'modified', backendSha });
@@ -431,7 +415,7 @@ export class AgentSync {
                 }
             }
             if (this.lastSyncTimestamp && this.lastSyncTimestamp.versionId !== backendResult.versionId) {
-                for (const [filePath, backendSha] of backendResult.checksums) {
+                for (const [filePath, backendSha] of filteredBackend) {
                     if (!baseline.has(filePath) && !diskComputed.checksums.has(filePath)) {
                         result.push({ path: filePath, status: 'backend-only', backendSha });
                     }
@@ -439,7 +423,7 @@ export class AgentSync {
             }
         }
         else {
-            const sortedBackend = [...backendResult.checksums.entries()].sort((a, b) => a[0].localeCompare(b[0]));
+            const sortedBackend = [...filteredBackend.entries()].sort((a, b) => a[0].localeCompare(b[0]));
             for (const [filePath, backendSha] of sortedBackend) {
                 const diskSha = diskComputed.checksums.get(filePath);
                 if (diskSha) {
@@ -456,7 +440,7 @@ export class AgentSync {
             }
             const sortedDisk = [...diskComputed.checksums.entries()].sort((a, b) => a[0].localeCompare(b[0]));
             for (const [filePath, diskSha] of sortedDisk) {
-                if (!backendResult.checksums.has(filePath) && isUserCreatedFile(filePath)) {
+                if (!filteredBackend.has(filePath) && isUserCreatedFile(filePath)) {
                     result.push({ path: filePath, status: 'disk-only', diskSha });
                 }
             }
@@ -578,6 +562,49 @@ export class AgentSync {
             return null;
         }
     }
+    /**
+     * Pull files from the backend DB and write them to disk.
+     * This fetches ALL project files and overwrites local versions.
+     * Files that exist only on disk (not in DB) are left untouched.
+     */
+    async pullFromBackend() {
+        const url = `${this.backendUrl}/api/sandbox/files?projectId=${this.projectId}`;
+        const response = await fetch(url);
+        if (!response.ok) {
+            throw new Error(`Failed to fetch files from backend: ${response.status}`);
+        }
+        const data = await response.json();
+        if (!data.files || data.files.length === 0) {
+            return { success: true, filesWritten: 0 };
+        }
+        // Ensure directories exist
+        const dirsToCreate = new Set();
+        for (const file of data.files) {
+            const filePath = path.join(this.projectDir, file.path);
+            dirsToCreate.add(path.dirname(filePath));
+        }
+        for (const dir of dirsToCreate) {
+            await fs.mkdir(dir, { recursive: true }).catch(() => { });
+        }
+        // Write files in parallel batches
+        const BATCH_SIZE = 50;
+        let written = 0;
+        for (let i = 0; i < data.files.length; i += BATCH_SIZE) {
+            const batch = data.files.slice(i, i + BATCH_SIZE);
+            await Promise.all(batch.map(async (file) => {
+                const filePath = path.join(this.projectDir, file.path);
+                await fs.writeFile(filePath, file.content, 'utf-8');
+            }));
+            written += batch.length;
+        }
+        // Invalidate caches and re-establish baseline
+        this.diskChecksumCache = null;
+        this.backendChecksumCache = null;
+        const versionId = String(data.versionId);
+        this.markSynced(versionId);
+        console.log(`  [AgentSync] Pulled ${written} files from backend (version ${versionId})`);
+        return { success: true, filesWritten: written, versionId };
+    }
     // ─── Cleanup ──────────────────────────────────────────────
     destroy() {
         this.stopFileWatcher();

package/dist/cli.js

@@ -25,7 +25,7 @@ const program = new Command();
 program
     .name('nstantpage')
     .description('Local development agent for nstantpage.com — run projects on your machine, preview in the cloud')
-    .version('0.5.27');
+    .version('0.5.29');
 program
     .command('login')
     .description('Authenticate with nstantpage.com')

package/dist/commands/start.js

@@ -26,7 +26,7 @@ import { LocalServer } from '../localServer.js';
 import { PackageInstaller } from '../packageInstaller.js';
 import { probeLocalPostgres, ensureLocalProjectDb, closeAdminPool, writeDatabaseUrlToEnv } from '../projectDb.js';
 import { StatusServer } from '../statusServer.js';
-const VERSION = '0.5.27';
+const VERSION = '0.5.29';
 /**
  * Resolve the backend API base URL.
  * - If --backend is passed, use it

package/dist/localServer.d.ts

@@ -127,6 +127,7 @@ export declare class LocalServer {
     private handleSyncStatus;
     private handleSyncDiff;
     private handlePushToBackend;
+    private handlePullFromBackend;
     private handleDiskFile;
     private handleHealth;
     /**

package/dist/localServer.js

@@ -282,6 +282,7 @@ export class LocalServer {
             '/live/sync-status': this.handleSyncStatus,
             '/live/sync-diff': this.handleSyncDiff,
             '/live/push-to-backend': this.handlePushToBackend,
+            '/live/pull-from-backend': this.handlePullFromBackend,
             '/live/disk-file': this.handleDiskFile,
             '/health': this.handleHealth,
         };
@@ -1102,6 +1103,21 @@ export class LocalServer {
             this.json(res, { success: false, error: error.message }, 500);
         }
     }
+    // ─── /live/pull-from-backend ──────────────────────────────────
+    async handlePullFromBackend(_req, res) {
+        if (!this.agentSync) {
+            this.json(res, { success: false, error: 'Sync not available (no backendUrl configured)' }, 503);
+            return;
+        }
+        try {
+            const result = await this.agentSync.pullFromBackend();
+            this.json(res, result);
+        }
+        catch (error) {
+            console.error(`  [LocalServer] pull-from-backend error:`, error.message);
+            this.json(res, { success: false, error: error.message }, 500);
+        }
+    }
     // ─── /live/disk-file ─────────────────────────────────────────
     async handleDiskFile(_req, res, _body, url) {
         const filePath = url.searchParams.get('path');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nstantpage-agent",
-  "version": "0.5.27",
+  "version": "0.5.29",
   "description": "Local development agent for nstantpage.com — run your projects locally, preview in the cloud. Replaces cloud containers for faster builds.",
   "type": "module",
   "bin": {