pushwork 2.0.0-preview.2 → 2.0.0-preview.3

package/dist/core/snapshot.js

@@ -0,0 +1,254 @@
+"use strict";
+/**
+ * pvh TODO: the files & directories could be unified into a single map of entries with a type field
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SnapshotManager = void 0;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+const utils_1 = require("../utils");
+const output_1 = require("../utils/output");
+/**
+ * Manages sync snapshots for local state tracking
+ */
+class SnapshotManager {
+    constructor(rootPath) {
+        this.rootPath = rootPath;
+    }
+    /**
+     * Get path to sync tool directory
+     */
+    getSyncToolDir() {
+        return path.join(this.rootPath, SnapshotManager.SYNC_TOOL_DIR);
+    }
+    /**
+     * Get path to snapshot file
+     */
+    getSnapshotPath() {
+        return path.join(this.getSyncToolDir(), SnapshotManager.SNAPSHOT_FILENAME);
+    }
+    /**
+     * Check if snapshot exists
+     */
+    async exists() {
+        return await (0, utils_1.pathExists)(this.getSnapshotPath());
+    }
+    /**
+     * Load snapshot from disk
+     */
+    async load() {
+        try {
+            const snapshotPath = this.getSnapshotPath();
+            if (!(await (0, utils_1.pathExists)(snapshotPath))) {
+                return null;
+            }
+            const content = await fs.readFile(snapshotPath, "utf8");
+            const serializable = JSON.parse(content);
+            return this.deserializeSnapshot(serializable);
+        }
+        catch (error) {
+            output_1.out.taskLine(`Failed to load snapshot: ${error}`);
+            return null;
+        }
+    }
+    /**
+     * Save snapshot to disk
+     */
+    async save(snapshot) {
+        try {
+            await (0, utils_1.ensureDirectoryExists)(this.getSyncToolDir());
+            const serializable = this.serializeSnapshot(snapshot);
+            const content = JSON.stringify(serializable, null, 2);
+            await fs.writeFile(this.getSnapshotPath(), content, "utf8");
+        }
+        catch (error) {
+            throw new Error(`Failed to save snapshot: ${error}`);
+        }
+    }
+    /**
+     * Create empty snapshot
+     */
+    createEmpty() {
+        return {
+            timestamp: Date.now(),
+            rootPath: this.rootPath,
+            rootDirectoryUrl: undefined,
+            files: new Map(),
+            directories: new Map(),
+        };
+    }
+    /**
+     * Update file entry in snapshot
+     */
+    updateFileEntry(snapshot, relativePath, entry) {
+        snapshot.files.set(relativePath, entry);
+        snapshot.timestamp = Date.now();
+    }
+    /**
+     * Update directory entry in snapshot
+     */
+    updateDirectoryEntry(snapshot, relativePath, entry) {
+        snapshot.directories.set(relativePath, entry);
+        snapshot.timestamp = Date.now();
+    }
+    /**
+     * Remove file entry from snapshot
+     */
+    removeFileEntry(snapshot, relativePath) {
+        snapshot.files.delete(relativePath);
+        snapshot.timestamp = Date.now();
+    }
+    /**
+     * Remove directory entry from snapshot
+     */
+    removeDirectoryEntry(snapshot, relativePath) {
+        snapshot.directories.delete(relativePath);
+        snapshot.timestamp = Date.now();
+    }
+    /**
+     * Get all file paths in snapshot
+     */
+    getFilePaths(snapshot) {
+        return Array.from(snapshot.files.keys());
+    }
+    /**
+     * Get all directory paths in snapshot
+     */
+    getDirectoryPaths(snapshot) {
+        return Array.from(snapshot.directories.keys());
+    }
+    /**
+     * Get file entry by path
+     */
+    getFileEntry(snapshot, relativePath) {
+        return snapshot.files.get(relativePath);
+    }
+    /**
+     * Get directory entry by path
+     */
+    getDirectoryEntry(snapshot, relativePath) {
+        return snapshot.directories.get(relativePath);
+    }
+    /**
+     * Check if path is tracked in snapshot
+     */
+    isTracked(snapshot, relativePath) {
+        return (snapshot.files.has(relativePath) || snapshot.directories.has(relativePath));
+    }
+    /**
+     * Get snapshot statistics
+     */
+    getStats(snapshot) {
+        return {
+            files: snapshot.files.size,
+            directories: snapshot.directories.size,
+            timestamp: new Date(snapshot.timestamp),
+        };
+    }
+    /**
+     * Validate snapshot integrity
+     */
+    validate(snapshot) {
+        const errors = [];
+        if (!snapshot.timestamp || snapshot.timestamp <= 0) {
+            errors.push("Invalid timestamp");
+        }
+        if (!snapshot.rootPath) {
+            errors.push("Missing root path");
+        }
+        if (!snapshot.files || !snapshot.directories) {
+            errors.push("Missing files or directories map");
+        }
+        // Check for path conflicts (file and directory with same path)
+        for (const filePath of snapshot.files.keys()) {
+            if (snapshot.directories.has(filePath)) {
+                errors.push(`Path conflict: ${filePath} exists as both file and directory`);
+            }
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+        };
+    }
+    /**
+     * Convert snapshot to serializable format
+     */
+    serializeSnapshot(snapshot) {
+        return {
+            timestamp: snapshot.timestamp,
+            rootPath: snapshot.rootPath,
+            rootDirectoryUrl: snapshot.rootDirectoryUrl,
+            files: Array.from(snapshot.files.entries()),
+            directories: Array.from(snapshot.directories.entries()),
+        };
+    }
+    /**
+     * Convert serializable format back to snapshot
+     */
+    deserializeSnapshot(serializable) {
+        return {
+            timestamp: serializable.timestamp,
+            rootPath: serializable.rootPath,
+            rootDirectoryUrl: serializable.rootDirectoryUrl,
+            files: new Map(serializable.files),
+            directories: new Map(serializable.directories),
+        };
+    }
+    /**
+     * Clear all snapshot data
+     */
+    clear(snapshot) {
+        snapshot.files.clear();
+        snapshot.directories.clear();
+        snapshot.timestamp = Date.now();
+    }
+    /**
+     * Clone snapshot for safe manipulation
+     */
+    clone(snapshot) {
+        return {
+            timestamp: snapshot.timestamp,
+            rootPath: snapshot.rootPath,
+            rootDirectoryUrl: snapshot.rootDirectoryUrl,
+            files: new Map(snapshot.files),
+            directories: new Map(snapshot.directories),
+        };
+    }
+}
+exports.SnapshotManager = SnapshotManager;
+SnapshotManager.SNAPSHOT_FILENAME = "snapshot.json";
+SnapshotManager.SYNC_TOOL_DIR = ".pushwork";
+//# sourceMappingURL=snapshot.js.map

package/dist/core/snapshot.js.map

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

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

@@ -0,0 +1,177 @@
+import { AutomergeUrl, Repo } from "@automerge/automerge-repo";
+import { SyncSnapshot, SyncResult, DirectoryDocument, MoveCandidate, DirectoryConfig, DetectedChange } from "../types";
+/**
+ * Nuke an artifact directory's docs array and rebuild it from scratch.
+ * Entries must be spread into plain objects — pushing Automerge proxy objects
+ * back after splicing them out throws "Cannot create a reference to an
+ * existing document object".
+ */
+export declare function nukeAndRebuildDocs(doc: DirectoryDocument, dirPath: string, newEntries: {
+    name: string;
+    url: AutomergeUrl;
+}[], updatedEntries: {
+    name: string;
+    url: AutomergeUrl;
+}[], deletedNames: string[], subdirUpdates: {
+    name: string;
+    url: AutomergeUrl;
+}[]): void;
+/**
+ * Bidirectional sync engine implementing two-phase sync
+ */
+export declare class SyncEngine {
+    private repo;
+    private rootPath;
+    private snapshotManager;
+    private changeDetector;
+    private moveDetector;
+    private handlesByPath;
+    private config;
+    constructor(repo: Repo, rootPath: string, config: DirectoryConfig);
+    /**
+     * Determine if content should be treated as text for Automerge text operations
+     * Note: This method checks the runtime type. File type detection happens
+     * during reading with isEnhancedTextFile() which now has better dev file support.
+     */
+    private isTextContent;
+    /**
+     * Get a versioned URL from a handle (includes current heads).
+     * This ensures clients can fetch the exact version of the document.
+     */
+    private getVersionedUrl;
+    /**
+     * Determine if a file path is inside an artifact directory.
+     * Artifact files are stored as immutable strings (RawString) and
+     * referenced with versioned URLs in directory entries.
+     */
+    private isArtifactPath;
+    /**
+     * Get the appropriate URL for a file's directory entry.
+     * Artifact paths get versioned URLs (with heads) for exact version fetching.
+     * Non-artifact paths get plain URLs for collaborative editing.
+     */
+    private getEntryUrl;
+    /**
+     * Get the appropriate URL for a subdirectory's directory entry.
+     * Artifact directories get versioned URLs (with heads) so consumers can
+     * fetch the exact snapshotted version, matching how artifact files work.
+     * Non-artifact directories get plain URLs for collaborative editing.
+     */
+    private getDirEntryUrl;
+    /**
+     * Set the root directory URL in the snapshot
+     */
+    getRootDirectoryUrl(): Promise<AutomergeUrl | undefined>;
+    setRootDirectoryUrl(url: AutomergeUrl): Promise<void>;
+    /**
+     * Reset the snapshot, clearing all tracked files and directories.
+     * Preserves the rootDirectoryUrl so sync can still operate.
+     * Used by --force to re-sync every file.
+     */
+    resetSnapshot(): Promise<void>;
+    /**
+     * Nuclear reset: clear the snapshot AND wipe the root directory document's
+     * entries so that every file and subdirectory gets brand-new Automerge
+     * documents. The root directory document itself is preserved.
+     */
+    nuclearReset(): Promise<void>;
+    /**
+     * Commit local changes only (no network sync)
+     */
+    commitLocal(): Promise<SyncResult>;
+    /**
+     * Recreate documents that failed to sync. Creates new Automerge documents
+     * with the same content and updates all references (snapshot, parent directory).
+     * Returns new handles that should be retried for sync.
+     */
+    private recreateFailedDocuments;
+    /**
+     * Run full bidirectional sync
+     */
+    sync(options?: {
+        sub?: boolean;
+    }): Promise<SyncResult>;
+    /**
+     * Phase 1: Push local changes to Automerge documents.
+     *
+     * Works depth-first: processes the deepest files first, creates/updates all
+     * file docs at each level, then batch-updates the parent directory document
+     * in a single change. Propagates subdirectory URL updates as we walk up
+     * toward the root. This eliminates the need for a separate URL update pass.
+     */
+    private pushLocalChanges;
+    /**
+     * Phase 2: Pull remote changes to local filesystem
+     */
+    private pullRemoteChanges;
+    /**
+     * Apply remote change to local filesystem
+     */
+    private applyRemoteChangeToLocal;
+    /**
+     * Apply move to remote documents
+     */
+    private applyMoveToRemote;
+    /**
+     * Create new remote file document
+     */
+    private createRemoteFile;
+    /**
+     * Update existing remote file document
+     */
+    private updateRemoteFile;
+    /**
+     * Delete remote file document
+     */
+    private deleteRemoteFile;
+    /**
+     * Add file entry to appropriate directory document (maintains hierarchy)
+     */
+    private addFileToDirectory;
+    /**
+     * Ensure directory document exists for the given path, creating hierarchy as needed
+     * First checks for existing shared directories before creating new ones
+     */
+    private ensureDirectoryDocument;
+    /**
+     * Remove file entry from directory document
+     */
+    private removeFileFromDirectory;
+    /**
+     * Batch-update a directory document in a single change: add new file entries,
+     * update URLs for modified files, remove deleted entries, and update
+     * subdirectory URLs. This replaces the separate per-file directory mutations
+     * and the post-hoc URL update pass.
+     */
+    private batchUpdateDirectory;
+    /**
+     * Sort changes by dependency order
+     */
+    private sortChangesByDependency;
+    /**
+     * Get sync status
+     */
+    getStatus(): Promise<{
+        snapshot: SyncSnapshot | null;
+        hasChanges: boolean;
+        changeCount: number;
+        lastSync: Date | null;
+    }>;
+    /**
+     * Preview changes without applying them
+     */
+    previewChanges(): Promise<{
+        changes: DetectedChange[];
+        moves: MoveCandidate[];
+        summary: string;
+    }>;
+    /**
+     * Generate human-readable summary of changes
+     */
+    private generateChangeSummary;
+    /**
+     * Update the lastSyncAt timestamp on the root directory document
+     */
+    private touchRootDirectory;
+}
+//# sourceMappingURL=sync-engine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sync-engine.d.ts","sourceRoot":"","sources":["../../src/core/sync-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,YAAY,EACZ,IAAI,EAKJ,MAAM,2BAA2B,CAAA;AAElC,OAAO,EACN,YAAY,EACZ,UAAU,EAEV,iBAAiB,EAIjB,aAAa,EACb,eAAe,EACf,cAAc,EACd,MAAM,UAAU,CAAA;AA0CjB;;;;;GAKG;AACH,wBAAgB,kBAAkB,CACjC,GAAG,EAAE,iBAAiB,EACtB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,YAAY,CAAA;CAAC,EAAE,EAC/C,cAAc,EAAE;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,YAAY,CAAA;CAAC,EAAE,EACnD,YAAY,EAAE,MAAM,EAAE,EACtB,aAAa,EAAE;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,YAAY,CAAA;CAAC,EAAE,GAChD,IAAI,CA2CN;AAOD;;GAEG;AACH,qBAAa,UAAU;IAUrB,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,QAAQ;IAVjB,OAAO,CAAC,eAAe,CAAiB;IACxC,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,YAAY,CAAc;IAGlC,OAAO,CAAC,aAAa,CAA6C;IAClE,OAAO,CAAC,MAAM,CAAiB;gBAGtB,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,MAAM,EACxB,MAAM,EAAE,eAAe;IAaxB;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAKrB;;;OAGG;IACH,OAAO,CAAC,eAAe;IAMvB;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAOtB;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAOnB;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IAOtB;;OAEG;IACG,mBAAmB,IAAI,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAKxD,mBAAmB,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAS3D;;;;OAIG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAOpC;;;;OAIG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAmBnC;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,UAAU,CAAC;IA0DxC;;;;OAIG;YACW,uBAAuB;IAsGrC;;OAEG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE;QAAC,GAAG,CAAC,EAAE,OAAO,CAAA;KAAC,GAAG,OAAO,CAAC,UAAU,CAAC;IAqT1D;;;;;;;OAOG;YACW,gBAAgB;IAqP9B;;OAEG;YACW,iBAAiB;IAuC/B;;OAEG;YACW,wBAAwB;IAkEtC;;OAEG;YACW,iBAAiB;IA4F/B;;OAEG;YACW,gBAAgB;IA0C9B;;OAEG;YACW,gBAAgB;IAmG9B;;OAEG;YACW,gBAAgB;IAW9B;;OAEG;YACW,kBAAkB;IA8ChC;;;OAGG;YACW,uBAAuB;IA+HrC;;OAEG;YACW,uBAAuB;IA0DrC;;;;;OAKG;YACW,oBAAoB;IAkGlC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAS/B;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC;QAC1B,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAA;QAC7B,UAAU,EAAE,OAAO,CAAA;QACnB,WAAW,EAAE,MAAM,CAAA;QACnB,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAA;KACrB,CAAC;IAsBF;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC;QAC/B,OAAO,EAAE,cAAc,EAAE,CAAA;QACzB,KAAK,EAAE,aAAa,EAAE,CAAA;QACtB,OAAO,EAAE,MAAM,CAAA;KACf,CAAC;IAkBF;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA+C7B;;OAEG;YACW,kBAAkB;CAiChC"}