pushwork 2.0.0-preview.2 → 2.0.0-preview.4

package/dist/types/snapshot.d.ts

@@ -0,0 +1,64 @@
+import { AutomergeUrl, UrlHeads } from "@automerge/automerge-repo";
+/**
+ * Tracked file entry in the sync snapshot
+ */
+export interface SnapshotFileEntry {
+    path: string;
+    url: AutomergeUrl;
+    head: UrlHeads;
+    extension: string;
+    mimeType: string;
+    contentHash?: string;
+}
+/**
+ * Tracked directory entry in the sync snapshot
+ */
+export interface SnapshotDirectoryEntry {
+    path: string;
+    url: AutomergeUrl;
+    head: UrlHeads;
+    entries: string[];
+}
+/**
+ * Sync snapshot for local state management
+ */
+export interface SyncSnapshot {
+    timestamp: number;
+    rootPath: string;
+    rootDirectoryUrl?: AutomergeUrl;
+    files: Map<string, SnapshotFileEntry>;
+    directories: Map<string, SnapshotDirectoryEntry>;
+}
+/**
+ * Serializable version of sync snapshot for storage
+ */
+export interface SerializableSyncSnapshot {
+    timestamp: number;
+    rootPath: string;
+    rootDirectoryUrl?: AutomergeUrl;
+    files: Array<[string, SnapshotFileEntry]>;
+    directories: Array<[string, SnapshotDirectoryEntry]>;
+}
+/**
+ * Sync operation result
+ */
+export interface SyncResult {
+    success: boolean;
+    filesChanged: number;
+    directoriesChanged: number;
+    errors: SyncError[];
+    warnings: string[];
+    timings?: {
+        [key: string]: number;
+    };
+}
+/**
+ * Sync error details
+ */
+export interface SyncError {
+    path: string;
+    operation: string;
+    error: Error;
+    recoverable: boolean;
+}
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/types/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/types/snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,YAAY,CAAC;IAClB,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,YAAY,CAAC;IAClB,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,YAAY,CAAC;IAChC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IACtC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;CAClD;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,YAAY,CAAC;IAChC,KAAK,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAC1C,WAAW,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC,CAAC;CACtD;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,KAAK,CAAC;IACb,WAAW,EAAE,OAAO,CAAC;CACtB"}

package/dist/types/snapshot.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=snapshot.js.map

package/dist/types/snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../src/types/snapshot.ts"],"names":[],"mappings":""}

package/dist/utils/content-similarity.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Content similarity calculation for move detection
+ */
+export declare class ContentSimilarity {
+    private static readonly CHUNK_SIZE;
+    private static readonly AUTO_THRESHOLD;
+    private static readonly PROMPT_THRESHOLD;
+    /**
+     * Calculate similarity between two content pieces
+     */
+    static calculateSimilarity(content1: string | Uint8Array, content2: string | Uint8Array): Promise<number>;
+    /**
+     * Check if two content pieces are identical
+     */
+    private static areIdentical;
+    /**
+     * Calculate similarity for small files using full content
+     */
+    private static calculateFullSimilarity;
+    /**
+     * Calculate similarity for large files using sampling
+     */
+    private static calculateSampledSimilarity;
+    /**
+     * Get representative samples from content
+     */
+    private static getSamples;
+    /**
+     * Calculate Levenshtein similarity (0-1 scale)
+     */
+    private static levenshteinSimilarity;
+    /**
+     * Calculate Levenshtein distance
+     */
+    private static levenshteinDistance;
+    /**
+     * Convert buffer to string for comparison
+     */
+    private static bufferToString;
+    /**
+     * Determine confidence level based on similarity score
+     */
+    static getConfidenceLevel(similarity: number): "auto" | "prompt" | "low";
+    /**
+     * Should auto-apply move based on similarity
+     */
+    static shouldAutoApply(similarity: number): boolean;
+    /**
+     * Should prompt user for move confirmation
+     */
+    static shouldPromptUser(similarity: number): boolean;
+}
+//# sourceMappingURL=content-similarity.d.ts.map

package/dist/utils/content-similarity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-similarity.d.ts","sourceRoot":"","sources":["../../src/utils/content-similarity.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAQ;IAC1C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAO;IAC7C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAO;IAE/C;;OAEG;WACU,mBAAmB,CAC9B,QAAQ,EAAE,MAAM,GAAG,UAAU,EAC7B,QAAQ,EAAE,MAAM,GAAG,UAAU,GAC5B,OAAO,CAAC,MAAM,CAAC;IA0BlB;;OAEG;mBACkB,YAAY;IASjC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,uBAAuB;IAYtC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,0BAA0B;IAkBzC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,UAAU;IAwBzB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAUpC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAsBlC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAO7B;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK;IAUxE;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAInD;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;CAKrD"}

package/dist/utils/content-similarity.js

@@ -0,0 +1,155 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContentSimilarity = void 0;
+const fs_1 = require("./fs");
+/**
+ * Content similarity calculation for move detection
+ */
+class ContentSimilarity {
+    /**
+     * Calculate similarity between two content pieces
+     */
+    static async calculateSimilarity(content1, content2) {
+        // Quick early exit for identical content
+        if (await this.areIdentical(content1, content2)) {
+            return 1.0;
+        }
+        // Size-based quick rejection
+        const size1 = typeof content1 === "string" ? content1.length : content1.length;
+        const size2 = typeof content2 === "string" ? content2.length : content2.length;
+        const sizeDiff = Math.abs(size1 - size2) / Math.max(size1, size2);
+        if (sizeDiff > 0.5) {
+            return 0.0; // Too different in size
+        }
+        // For small files, use full content comparison
+        if (size1 < this.CHUNK_SIZE * 4 && size2 < this.CHUNK_SIZE * 4) {
+            return this.calculateFullSimilarity(content1, content2);
+        }
+        // For large files, use sampling
+        return this.calculateSampledSimilarity(content1, content2);
+    }
+    /**
+     * Check if two content pieces are identical
+     */
+    static async areIdentical(content1, content2) {
+        const hash1 = await (0, fs_1.calculateContentHash)(content1);
+        const hash2 = await (0, fs_1.calculateContentHash)(content2);
+        return hash1 === hash2;
+    }
+    /**
+     * Calculate similarity for small files using full content
+     */
+    static calculateFullSimilarity(content1, content2) {
+        const str1 = typeof content1 === "string" ? content1 : this.bufferToString(content1);
+        const str2 = typeof content2 === "string" ? content2 : this.bufferToString(content2);
+        return this.levenshteinSimilarity(str1, str2);
+    }
+    /**
+     * Calculate similarity for large files using sampling
+     */
+    static calculateSampledSimilarity(content1, content2) {
+        const samples1 = this.getSamples(content1);
+        const samples2 = this.getSamples(content2);
+        let totalSimilarity = 0;
+        let comparisons = 0;
+        for (let i = 0; i < Math.min(samples1.length, samples2.length); i++) {
+            totalSimilarity += this.levenshteinSimilarity(samples1[i], samples2[i]);
+            comparisons++;
+        }
+        return comparisons > 0 ? totalSimilarity / comparisons : 0;
+    }
+    /**
+     * Get representative samples from content
+     */
+    static getSamples(content) {
+        const str = typeof content === "string" ? content : this.bufferToString(content);
+        const length = str.length;
+        const samples = [];
+        if (length <= this.CHUNK_SIZE) {
+            samples.push(str);
+            return samples;
+        }
+        // Beginning
+        samples.push(str.slice(0, this.CHUNK_SIZE));
+        // Middle
+        const midStart = Math.floor(length / 2) - Math.floor(this.CHUNK_SIZE / 2);
+        samples.push(str.slice(midStart, midStart + this.CHUNK_SIZE));
+        // End
+        samples.push(str.slice(-this.CHUNK_SIZE));
+        return samples;
+    }
+    /**
+     * Calculate Levenshtein similarity (0-1 scale)
+     */
+    static levenshteinSimilarity(str1, str2) {
+        if (str1 === str2)
+            return 1.0;
+        if (str1.length === 0 || str2.length === 0)
+            return 0.0;
+        const distance = this.levenshteinDistance(str1, str2);
+        const maxLength = Math.max(str1.length, str2.length);
+        return 1 - distance / maxLength;
+    }
+    /**
+     * Calculate Levenshtein distance
+     */
+    static levenshteinDistance(str1, str2) {
+        const matrix = Array(str2.length + 1)
+            .fill(null)
+            .map(() => Array(str1.length + 1).fill(null));
+        for (let i = 0; i <= str1.length; i++)
+            matrix[0][i] = i;
+        for (let j = 0; j <= str2.length; j++)
+            matrix[j][0] = j;
+        for (let j = 1; j <= str2.length; j++) {
+            for (let i = 1; i <= str1.length; i++) {
+                const indicator = str1[i - 1] === str2[j - 1] ? 0 : 1;
+                matrix[j][i] = Math.min(matrix[j][i - 1] + 1, // deletion
+                matrix[j - 1][i] + 1, // insertion
+                matrix[j - 1][i - 1] + indicator // substitution
+                );
+            }
+        }
+        return matrix[str2.length][str1.length];
+    }
+    /**
+     * Convert buffer to string for comparison
+     */
+    static bufferToString(buffer) {
+        // For binary content, use hex representation for comparison
+        return Array.from(buffer)
+            .map((b) => b.toString(16).padStart(2, "0"))
+            .join("");
+    }
+    /**
+     * Determine confidence level based on similarity score
+     */
+    static getConfidenceLevel(similarity) {
+        if (similarity >= this.AUTO_THRESHOLD) {
+            return "auto";
+        }
+        else if (similarity >= this.PROMPT_THRESHOLD) {
+            return "prompt";
+        }
+        else {
+            return "low";
+        }
+    }
+    /**
+     * Should auto-apply move based on similarity
+     */
+    static shouldAutoApply(similarity) {
+        return similarity >= this.AUTO_THRESHOLD;
+    }
+    /**
+     * Should prompt user for move confirmation
+     */
+    static shouldPromptUser(similarity) {
+        return (similarity >= this.PROMPT_THRESHOLD && similarity < this.AUTO_THRESHOLD);
+    }
+}
+exports.ContentSimilarity = ContentSimilarity;
+ContentSimilarity.CHUNK_SIZE = 1024; // 1KB chunks for sampling
+ContentSimilarity.AUTO_THRESHOLD = 0.8;
+ContentSimilarity.PROMPT_THRESHOLD = 0.5;
+//# sourceMappingURL=content-similarity.js.map

package/dist/utils/content-similarity.js.map

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

package/dist/utils/content.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Compute a SHA-256 hash of file content.
+ * Used to detect local changes for artifact files without reading remote docs.
+ */
+export declare function contentHash(content: string | Uint8Array): string;
+/**
+ * Compare two content pieces for equality
+ */
+export declare function isContentEqual(content1: string | Uint8Array | null, content2: string | Uint8Array | null): boolean;
+//# sourceMappingURL=content.d.ts.map

package/dist/utils/content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../src/utils/content.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAEhE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,EACpC,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,GACnC,OAAO,CAiBT"}

package/dist/utils/content.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.contentHash = contentHash;
+exports.isContentEqual = isContentEqual;
+const crypto_1 = require("crypto");
+/**
+ * Compute a SHA-256 hash of file content.
+ * Used to detect local changes for artifact files without reading remote docs.
+ */
+function contentHash(content) {
+    return (0, crypto_1.createHash)("sha256").update(content).digest("hex");
+}
+/**
+ * Compare two content pieces for equality
+ */
+function isContentEqual(content1, content2) {
+    if (content1 === content2)
+        return true;
+    if (content1 == null || content2 == null)
+        return false;
+    if (typeof content1 !== typeof content2)
+        return false;
+    if (typeof content1 === "string") {
+        return content1 === content2;
+    }
+    else {
+        // Compare Uint8Array using native Buffer.equals() for better performance
+        const buf1 = content1;
+        const buf2 = content2;
+        if (buf1.length !== buf2.length)
+            return false;
+        return Buffer.from(buf1).equals(Buffer.from(buf2));
+    }
+}
+//# sourceMappingURL=content.js.map

package/dist/utils/content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.js","sourceRoot":"","sources":["../../src/utils/content.ts"],"names":[],"mappings":";;AAMA,kCAEC;AAKD,wCAoBC;AAjCD,mCAAoC;AAEpC;;;GAGG;AACH,SAAgB,WAAW,CAAC,OAA4B;IACtD,OAAO,IAAA,mBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC5D,CAAC;AAED;;GAEG;AACH,SAAgB,cAAc,CAC5B,QAAoC,EACpC,QAAoC;IAEpC,IAAI,QAAQ,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACvC,IAAI,QAAQ,IAAI,IAAI,IAAI,QAAQ,IAAI,IAAI;QAAE,OAAO,KAAK,CAAC;IAEvD,IAAI,OAAO,QAAQ,KAAK,OAAO,QAAQ;QAAE,OAAO,KAAK,CAAC;IAEtD,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,OAAO,QAAQ,KAAK,QAAQ,CAAC;IAC/B,CAAC;SAAM,CAAC;QACN,yEAAyE;QACzE,MAAM,IAAI,GAAG,QAAsB,CAAC;QACpC,MAAM,IAAI,GAAG,QAAsB,CAAC;QAEpC,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QAE9C,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACrD,CAAC;AACH,CAAC"}

package/dist/utils/directory.d.ts

@@ -0,0 +1,24 @@
+import { AutomergeUrl, Repo } from "@automerge/automerge-repo";
+/**
+ * Get a plain URL (without heads) from any URL.
+ * Versioned URLs with heads return view handles, which show a frozen point in time.
+ * For internal navigation, we always want to see the CURRENT state of documents.
+ */
+export declare function getPlainUrl(url: AutomergeUrl): AutomergeUrl;
+/**
+ * Find a file in the directory hierarchy by path.
+ *
+ * IMPORTANT: This function strips heads from all URLs before navigation.
+ * This ensures we always see the CURRENT state of directories, not a frozen
+ * point-in-time view. This is critical because:
+ * 1. Directory documents store versioned URLs for subdirectories
+ * 2. These URLs may have been captured when the subdirectory was empty
+ * 3. Using versioned URLs would make files appear to not exist
+ * 4. This would trigger false "remote deletion" detection
+ */
+export declare function findFileInDirectoryHierarchy(repo: Repo, directoryUrl: AutomergeUrl, filePath: string): Promise<{
+    name: string;
+    type: string;
+    url: AutomergeUrl;
+} | null>;
+//# sourceMappingURL=directory.d.ts.map

package/dist/utils/directory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory.d.ts","sourceRoot":"","sources":["../../src/utils/directory.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,IAAI,EAGL,MAAM,2BAA2B,CAAC;AAGnC;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,YAAY,GAAG,YAAY,CAG3D;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,4BAA4B,CAChD,IAAI,EAAE,IAAI,EACV,YAAY,EAAE,YAAY,EAC1B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,YAAY,CAAA;CAAE,GAAG,IAAI,CAAC,CAuCnE"}

package/dist/utils/directory.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPlainUrl = getPlainUrl;
+exports.findFileInDirectoryHierarchy = findFileInDirectoryHierarchy;
+const automerge_repo_1 = require("@automerge/automerge-repo");
+/**
+ * Get a plain URL (without heads) from any URL.
+ * Versioned URLs with heads return view handles, which show a frozen point in time.
+ * For internal navigation, we always want to see the CURRENT state of documents.
+ */
+function getPlainUrl(url) {
+    const { documentId } = (0, automerge_repo_1.parseAutomergeUrl)(url);
+    return (0, automerge_repo_1.stringifyAutomergeUrl)({ documentId });
+}
+/**
+ * Find a file in the directory hierarchy by path.
+ *
+ * IMPORTANT: This function strips heads from all URLs before navigation.
+ * This ensures we always see the CURRENT state of directories, not a frozen
+ * point-in-time view. This is critical because:
+ * 1. Directory documents store versioned URLs for subdirectories
+ * 2. These URLs may have been captured when the subdirectory was empty
+ * 3. Using versioned URLs would make files appear to not exist
+ * 4. This would trigger false "remote deletion" detection
+ */
+async function findFileInDirectoryHierarchy(repo, directoryUrl, filePath) {
+    try {
+        const pathParts = filePath.split("/");
+        let currentDirUrl = getPlainUrl(directoryUrl);
+        // Navigate through directories to find the parent directory
+        for (let i = 0; i < pathParts.length - 1; i++) {
+            const dirName = pathParts[i];
+            const dirHandle = await repo.find(currentDirUrl);
+            const dirDoc = await dirHandle.doc();
+            if (!dirDoc)
+                return null;
+            const subDirEntry = dirDoc.docs.find((entry) => entry.name === dirName && entry.type === "folder");
+            if (!subDirEntry)
+                return null;
+            currentDirUrl = getPlainUrl(subDirEntry.url);
+        }
+        // Now look for the file in the final directory
+        const fileName = pathParts[pathParts.length - 1];
+        const finalDirHandle = await repo.find(currentDirUrl);
+        const finalDirDoc = await finalDirHandle.doc();
+        if (!finalDirDoc)
+            return null;
+        const fileEntry = finalDirDoc.docs.find((entry) => entry.name === fileName && entry.type === "file");
+        return fileEntry || null;
+    }
+    catch (error) {
+        // Failed to find file in hierarchy
+        return null;
+    }
+}
+//# sourceMappingURL=directory.js.map

package/dist/utils/directory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory.js","sourceRoot":"","sources":["../../src/utils/directory.ts"],"names":[],"mappings":";;AAaA,kCAGC;AAaD,oEA2CC;AAxED,8DAKmC;AAGnC;;;;GAIG;AACH,SAAgB,WAAW,CAAC,GAAiB;IAC3C,MAAM,EAAE,UAAU,EAAE,GAAG,IAAA,kCAAiB,EAAC,GAAG,CAAC,CAAC;IAC9C,OAAO,IAAA,sCAAqB,EAAC,EAAE,UAAU,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;;;;;;GAUG;AACI,KAAK,UAAU,4BAA4B,CAChD,IAAU,EACV,YAA0B,EAC1B,QAAgB;IAEhB,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,aAAa,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC;QAE9C,4DAA4D;QAC5D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC9C,MAAM,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;YAC7B,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,IAAI,CAAoB,aAAa,CAAC,CAAC;YACpE,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,CAAC;YAErC,IAAI,CAAC,MAAM;gBAAE,OAAO,IAAI,CAAC;YAEzB,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAClC,CAAC,KAAwD,EAAE,EAAE,CAC3D,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,CACpD,CAAC;YAEF,IAAI,CAAC,WAAW;gBAAE,OAAO,IAAI,CAAC;YAC9B,aAAa,GAAG,WAAW,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAC/C,CAAC;QAED,+CAA+C;QAC/C,MAAM,QAAQ,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACjD,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,IAAI,CAAoB,aAAa,CAAC,CAAC;QACzE,MAAM,WAAW,GAAG,MAAM,cAAc,CAAC,GAAG,EAAE,CAAC;QAE/C,IAAI,CAAC,WAAW;YAAE,OAAO,IAAI,CAAC;QAE9B,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CACrC,CAAC,KAAwD,EAAE,EAAE,CAC3D,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,CACnD,CAAC;QAEF,OAAO,SAAS,IAAI,IAAI,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,mCAAmC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/utils/fs.d.ts

@@ -0,0 +1,74 @@
+import { FileSystemEntry } from "../types";
+/**
+ * Check if a path exists
+ */
+export declare function pathExists(filePath: string): Promise<boolean>;
+/**
+ * Get file system entry metadata
+ */
+export declare function getFileSystemEntry(filePath: string): Promise<FileSystemEntry | null>;
+/**
+ * Determine if a file is text or binary
+ */
+export declare function isTextFile(filePath: string): Promise<boolean>;
+/**
+ * Read file content as string or buffer
+ */
+export declare function readFileContent(filePath: string): Promise<string | Uint8Array>;
+/**
+ * Write file content from string or buffer
+ */
+export declare function writeFileContent(filePath: string, content: string | Uint8Array): Promise<void>;
+/**
+ * Ensure directory exists, creating it if necessary
+ */
+export declare function ensureDirectoryExists(dirPath: string): Promise<void>;
+/**
+ * Remove file or directory
+ */
+export declare function removePath(filePath: string): Promise<void>;
+/**
+ * List directory contents with metadata
+ */
+export declare function listDirectory(dirPath: string, recursive?: boolean, excludePatterns?: string[]): Promise<FileSystemEntry[]>;
+/**
+ * Copy file with metadata preservation
+ */
+export declare function copyFile(sourcePath: string, destPath: string): Promise<void>;
+/**
+ * Move/rename file or directory
+ */
+export declare function movePath(sourcePath: string, destPath: string): Promise<void>;
+/**
+ * Calculate content hash for change detection
+ */
+export declare function calculateContentHash(content: string | Uint8Array): Promise<string>;
+/**
+ * Get MIME type for file
+ */
+export declare function getMimeType(filePath: string): string;
+/**
+ * Get file extension
+ */
+export declare function getFileExtension(filePath: string): string;
+/**
+ * Normalize path separators for cross-platform compatibility
+ * Converts all path separators to forward slashes for consistent storage
+ */
+export declare function normalizePath(filePath: string): string;
+/**
+ * Join paths and normalize separators for cross-platform compatibility
+ * Use this instead of string concatenation to ensure proper path handling on Windows
+ */
+export declare function joinAndNormalizePath(...paths: string[]): string;
+/**
+ * Get relative path from base directory
+ */
+export declare function getRelativePath(basePath: string, filePath: string): string;
+/**
+ * Format a path as a relative path with proper prefix
+ * Ensures paths like "src" become "./src" for clarity
+ * Leaves absolute paths and paths already starting with . or .. unchanged
+ */
+export declare function formatRelativePath(filePath: string): string;
+//# sourceMappingURL=fs.d.ts.map

package/dist/utils/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"AAMA,OAAO,EAAC,eAAe,EAAW,MAAM,UAAU,CAAA;AAGlD;;GAEG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOnE;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACvC,QAAQ,EAAE,MAAM,GACd,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAmBjC;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAwBnE;AAED;;GAEG;AACH,wBAAsB,eAAe,CACpC,QAAQ,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,GAAG,UAAU,CAAC,CAS9B;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACrC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GAAG,UAAU,GAC1B,OAAO,CAAC,IAAI,CAAC,CAQf;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ1E;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAahE;AAsBD;;GAEG;AACH,wBAAsB,aAAa,CAClC,OAAO,EAAE,MAAM,EACf,SAAS,UAAQ,EACjB,eAAe,GAAE,MAAM,EAAO,GAC5B,OAAO,CAAC,eAAe,EAAE,CAAC,CAoC5B;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAC7B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAC7B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAGf;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACzC,OAAO,EAAE,MAAM,GAAG,UAAU,GAC1B,OAAO,CAAC,MAAM,CAAC,CAIjB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGzD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAK/D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE1E;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAO3D"}