@agent-wire/terminal 1.6.0

package/dist/sync/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/sync/manifest.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAE7B,IAAI,CAAC,GAAG,CAAC,WAAW,IAAI,OAAO,GAAG,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;QAC5D,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,SAAS,IAAI,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;IAED,OAAO;QACL,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACpD,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,EAAE;KACvB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAsB;IACtD,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC5B,QAAsB,EACtB,OASE;IAEF,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,YAAY,GAAG,EAAE,GAAG,QAAQ,CAAC,KAAK,EAAE,CAAC;IAE3C,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,MAAM,GACV,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;QAEhE,MAAM,SAAS,GAAkB;YAC/B,WAAW,EAAE,KAAK,CAAC,UAAU;YAC7B,UAAU,EAAE,KAAK,CAAC,SAAS;YAC3B,WAAW,EAAE,KAAK,CAAC,UAAU;YAC7B,aAAa,EAAE,KAAK,CAAC,YAAY;YACjC,eAAe,EAAE,KAAK,CAAC,cAAc;YACrC,qBAAqB,EAAE,KAAK,CAAC,mBAAmB;YAChD,iBAAiB,EAAE,KAAK,CAAC,eAAe;YACxC,cAAc,EAAE,GAAG;YACnB,MAAM;SACP,CAAC;QAEF,YAAY,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,SAAS,CAAC;IAC/C,CAAC;IAED,OAAO;QACL,GAAG,QAAQ;QACX,SAAS,EAAE,GAAG;QACd,KAAK,EAAE,YAAY;KACpB,CAAC;AACJ,CAAC"}

package/dist/sync/match.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Document matching — maps local files to remote documents.
+ * Isomorphic — no Node.js dependencies.
+ *
+ * Matching strategy (in priority order):
+ * 1. Manifest-based: if a manifest exists, match by document_id
+ * 2. source_path-based: match by remote document's source_path field
+ * 3. Title-based: normalize filenames and titles, match by equality
+ *    - Prefer published over draft
+ *    - Exclude retracted documents
+ *    - Flag ambiguous matches (multiple docs with same normalized title)
+ */
+import type { LocalFile, RemoteDocument, SyncManifest } from './types.js';
+export interface MatchResult {
+    local?: LocalFile;
+    remote?: RemoteDocument;
+    matchedBy: 'manifest' | 'title' | 'source_path';
+}
+/**
+ * Normalize a filename to a comparable title string.
+ * Strips .md/.txt/.html extensions, converts hyphens and underscores
+ * to spaces, lowercases, trims, and collapses whitespace.
+ */
+export declare function normalizeTitle(filename: string): string;
+/**
+ * Match local files to remote documents.
+ * Returns a Map keyed by relativePath with match results.
+ */
+export declare function matchDocuments(localFiles: Map<string, LocalFile>, remoteDocs: RemoteDocument[], manifest: SyncManifest | null): Map<string, MatchResult>;

package/dist/sync/match.js

@@ -0,0 +1,153 @@
+/**
+ * Document matching — maps local files to remote documents.
+ * Isomorphic — no Node.js dependencies.
+ *
+ * Matching strategy (in priority order):
+ * 1. Manifest-based: if a manifest exists, match by document_id
+ * 2. source_path-based: match by remote document's source_path field
+ * 3. Title-based: normalize filenames and titles, match by equality
+ *    - Prefer published over draft
+ *    - Exclude retracted documents
+ *    - Flag ambiguous matches (multiple docs with same normalized title)
+ */
+/**
+ * Normalize a filename to a comparable title string.
+ * Strips .md/.txt/.html extensions, converts hyphens and underscores
+ * to spaces, lowercases, trims, and collapses whitespace.
+ */
+export function normalizeTitle(filename) {
+    // Strip common extensions
+    let name = filename.replace(/\.(md|txt|html)$/i, '');
+    // Remove any leading directory path
+    const lastSlash = name.lastIndexOf('/');
+    if (lastSlash >= 0) {
+        name = name.substring(lastSlash + 1);
+    }
+    // Normalize hyphens and underscores to spaces
+    name = name.replace(/[-_]/g, ' ');
+    // Lowercase and collapse whitespace
+    return name.toLowerCase().replace(/\s+/g, ' ').trim();
+}
+/**
+ * Match local files to remote documents.
+ * Returns a Map keyed by relativePath with match results.
+ */
+export function matchDocuments(localFiles, remoteDocs, manifest) {
+    const results = new Map();
+    // Filter out retracted docs for matching purposes
+    const activeRemoteDocs = remoteDocs.filter(d => d.status !== 'retracted');
+    // Track which remote docs have been claimed
+    const claimedRemoteIds = new Set();
+    // ── Pass 1: Manifest-based matching ──────────────────────
+    if (manifest) {
+        for (const [relPath, entry] of Object.entries(manifest.files)) {
+            const local = localFiles.get(relPath);
+            const remote = activeRemoteDocs.find(d => d.id === entry.document_id);
+            if (local || remote) {
+                results.set(relPath, {
+                    local: local || undefined,
+                    remote: remote || undefined,
+                    matchedBy: 'manifest',
+                });
+                if (remote)
+                    claimedRemoteIds.add(remote.id);
+            }
+        }
+    }
+    // ── Pass 2: source_path matching for unmatched files ─────
+    for (const [relPath, local] of localFiles) {
+        if (results.has(relPath))
+            continue;
+        const matchByPath = activeRemoteDocs.find(d => !claimedRemoteIds.has(d.id) && d.source_path === relPath);
+        if (matchByPath) {
+            results.set(relPath, {
+                local,
+                remote: matchByPath,
+                matchedBy: 'source_path',
+            });
+            claimedRemoteIds.add(matchByPath.id);
+        }
+    }
+    // ── Pass 3: Title-based matching for remaining unmatched ─
+    // Build a map of normalized titles to remote docs (prefer published)
+    const titleMap = new Map();
+    for (const doc of activeRemoteDocs) {
+        if (claimedRemoteIds.has(doc.id))
+            continue;
+        const normTitle = normalizeTitle(doc.title);
+        const existing = titleMap.get(normTitle) || [];
+        existing.push(doc);
+        titleMap.set(normTitle, existing);
+    }
+    for (const [relPath, local] of localFiles) {
+        if (results.has(relPath))
+            continue;
+        const normFilename = normalizeTitle(relPath);
+        const candidates = titleMap.get(normFilename);
+        if (candidates && candidates.length > 0) {
+            // Sort: prefer published over draft
+            const sorted = [...candidates].sort((a, b) => {
+                if (a.status === 'published' && b.status !== 'published')
+                    return -1;
+                if (b.status === 'published' && a.status !== 'published')
+                    return 1;
+                // Prefer higher version number
+                return b.version_number - a.version_number;
+            });
+            const bestMatch = sorted[0];
+            // Only match if unambiguous (one candidate) or there's a clear published winner
+            if (candidates.length === 1 || bestMatch.status === 'published') {
+                results.set(relPath, {
+                    local,
+                    remote: bestMatch,
+                    matchedBy: 'title',
+                });
+                claimedRemoteIds.add(bestMatch.id);
+                // Remove from title map
+                const remaining = candidates.filter(c => c.id !== bestMatch.id);
+                if (remaining.length > 0) {
+                    titleMap.set(normFilename, remaining);
+                }
+                else {
+                    titleMap.delete(normFilename);
+                }
+            }
+            else {
+                // Ambiguous — local-only, no match
+                results.set(relPath, {
+                    local,
+                    remote: undefined,
+                    matchedBy: 'title',
+                });
+            }
+        }
+        else {
+            // No match at all — local only
+            results.set(relPath, {
+                local,
+                remote: undefined,
+                matchedBy: 'title',
+            });
+        }
+    }
+    // ── Pass 4: Remote-only documents (no local match) ───────
+    for (const doc of activeRemoteDocs) {
+        if (claimedRemoteIds.has(doc.id))
+            continue;
+        // Use source_path if available, otherwise derive from title
+        let relPath = doc.source_path || `${doc.title.replace(/[^a-zA-Z0-9\s-_]/g, '').replace(/\s+/g, '-').toLowerCase()}.md`;
+        // If path collides, disambiguate with short doc ID suffix
+        if (results.has(relPath)) {
+            const ext = relPath.endsWith('.md') ? '.md' : relPath.endsWith('.txt') ? '.txt' : relPath.endsWith('.html') ? '.html' : '';
+            const base = ext ? relPath.slice(0, -ext.length) : relPath;
+            relPath = `${base}-${doc.id.slice(0, 8)}${ext}`;
+        }
+        results.set(relPath, {
+            local: undefined,
+            remote: doc,
+            matchedBy: doc.source_path ? 'source_path' : 'title',
+        });
+    }
+    return results;
+}
+//# sourceMappingURL=match.js.map

package/dist/sync/match.js.map

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

package/dist/sync/paginate.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Auto-pagination helper.
+ * Isomorphic — no Node.js dependencies.
+ *
+ * Fetches pages until a page returns fewer than pageSize results,
+ * indicating the last page has been reached.
+ */
+/**
+ * Paginate through all results from a fetch function.
+ * Concatenates pages until a page returns fewer than pageSize items.
+ *
+ * @param fetchPage - Function that fetches a page (1-indexed page number, pageSize)
+ * @param pageSize - Number of items per page (default 100)
+ * @returns All items concatenated
+ */
+export declare function paginateAll<T>(fetchPage: (page: number, pageSize: number) => Promise<T[]>, pageSize?: number): Promise<T[]>;

package/dist/sync/paginate.js

@@ -0,0 +1,34 @@
+/**
+ * Auto-pagination helper.
+ * Isomorphic — no Node.js dependencies.
+ *
+ * Fetches pages until a page returns fewer than pageSize results,
+ * indicating the last page has been reached.
+ */
+/**
+ * Paginate through all results from a fetch function.
+ * Concatenates pages until a page returns fewer than pageSize items.
+ *
+ * @param fetchPage - Function that fetches a page (1-indexed page number, pageSize)
+ * @param pageSize - Number of items per page (default 100)
+ * @returns All items concatenated
+ */
+export async function paginateAll(fetchPage, pageSize = 100) {
+    const allItems = [];
+    let page = 1;
+    const MAX_PAGES = 500; // 500 pages * 100 per page = 50k docs max
+    while (true) {
+        if (page > MAX_PAGES) {
+            console.error(`[wire-sync] Pagination stopped at ${MAX_PAGES} pages (${allItems.length} items). If your corpus has more documents, contact support.`);
+            break;
+        }
+        const items = await fetchPage(page, pageSize);
+        allItems.push(...items);
+        if (items.length < pageSize) {
+            break;
+        }
+        page++;
+    }
+    return allItems;
+}
+//# sourceMappingURL=paginate.js.map

package/dist/sync/paginate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paginate.js","sourceRoot":"","sources":["../../src/sync/paginate.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,SAA2D,EAC3D,QAAQ,GAAG,GAAG;IAEd,MAAM,QAAQ,GAAQ,EAAE,CAAC;IACzB,IAAI,IAAI,GAAG,CAAC,CAAC;IAEb,MAAM,SAAS,GAAG,GAAG,CAAC,CAAE,0CAA0C;IAElE,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,IAAI,GAAG,SAAS,EAAE,CAAC;YACrB,OAAO,CAAC,KAAK,CAAC,qCAAqC,SAAS,WAAW,QAAQ,CAAC,MAAM,8DAA8D,CAAC,CAAC;YACtJ,MAAM;QACR,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC9C,QAAQ,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;QAExB,IAAI,KAAK,CAAC,MAAM,GAAG,QAAQ,EAAE,CAAC;YAC5B,MAAM;QACR,CAAC;QAED,IAAI,EAAE,CAAC;IACT,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/sync/preview.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Preview generation for sync operations.
+ * Isomorphic — no Node.js dependencies.
+ *
+ * Produces both human-readable ASCII box-drawing output (for CLI)
+ * and structured JSON (for programmatic consumers).
+ */
+import type { PreviewOutput } from './types.js';
+/**
+ * Generate a human-readable ASCII preview of sync operations.
+ */
+export declare function generatePreview(result: PreviewOutput): string;
+/**
+ * Generate structured JSON preview for programmatic use.
+ */
+export declare function generatePreviewJson(result: PreviewOutput): object;

package/dist/sync/preview.js

@@ -0,0 +1,179 @@
+/**
+ * Preview generation for sync operations.
+ * Isomorphic — no Node.js dependencies.
+ *
+ * Produces both human-readable ASCII box-drawing output (for CLI)
+ * and structured JSON (for programmatic consumers).
+ */
+const BOX_WIDTH = 64;
+function pad(text, width) {
+    if (text.length >= width)
+        return text.substring(0, width);
+    return text + ' '.repeat(width - text.length);
+}
+function formatEntryLine(tag, entry) {
+    const lines = [];
+    const label = `[${tag}]`.padEnd(10);
+    const name = entry.relativePath;
+    const size = entry.sizeInfo ? `(${entry.sizeInfo})` : '';
+    // Main line: fit tag + name + size within box
+    const mainContent = `${label}${name}`;
+    const mainLine = size
+        ? `${mainContent.padEnd(BOX_WIDTH - size.length - 8)}${size}`
+        : mainContent;
+    lines.push(mainLine);
+    // Warning lines
+    for (const warning of entry.warnings) {
+        lines.push(`          \u26A0 ${warning}`);
+    }
+    return lines;
+}
+function boxSection(title, entries, tag) {
+    if (entries.length === 0)
+        return [];
+    const lines = [];
+    lines.push(`\u2551  ${pad(title, BOX_WIDTH - 4)} \u2551`);
+    lines.push(`\u2551  \u250C${'─'.repeat(BOX_WIDTH - 5)}\u2510 \u2551`);
+    for (const entry of entries) {
+        const entryLines = formatEntryLine(tag, entry);
+        for (const line of entryLines) {
+            lines.push(`\u2551  \u2502 ${pad(line, BOX_WIDTH - 6)}\u2502 \u2551`);
+        }
+    }
+    // For push_update entries, add the UPDATE tag differently
+    lines.push(`\u2551  \u2514${'─'.repeat(BOX_WIDTH - 5)}\u2518 \u2551`);
+    return lines;
+}
+/**
+ * Generate a human-readable ASCII preview of sync operations.
+ */
+export function generatePreview(result) {
+    const lines = [];
+    // Top border
+    lines.push(`\u2554${'═'.repeat(BOX_WIDTH)}\u2557`);
+    // Header
+    lines.push(`\u2551  ${pad('Wire Corpus Sync \u2014 Preview', BOX_WIDTH - 4)} \u2551`);
+    const localLabel = result.local_dir.length > 25
+        ? '...' + result.local_dir.slice(-22)
+        : result.local_dir;
+    lines.push(`\u2551  ${pad(`Local: ${localLabel}  \u2194  Wire: ${result.corpus_slug}`, BOX_WIDTH - 4)} \u2551`);
+    // Separator
+    lines.push(`\u2560${'═'.repeat(BOX_WIDTH)}\u2563`);
+    // Push section
+    const pushEntries = [
+        ...result.diff.push_new.map(e => ({ entry: e, tag: 'NEW' })),
+        ...result.diff.push_update.map(e => ({ entry: e, tag: 'UPDATE' })),
+    ];
+    if (pushEntries.length > 0) {
+        lines.push(`\u2551  ${pad('PUSH (Local \u2192 Wire)', BOX_WIDTH - 4)} \u2551`);
+        lines.push(`\u2551  \u250C${'─'.repeat(BOX_WIDTH - 5)}\u2510 \u2551`);
+        for (const { entry, tag } of pushEntries) {
+            const entryLines = formatEntryLine(tag, entry);
+            for (const line of entryLines) {
+                lines.push(`\u2551  \u2502 ${pad(line, BOX_WIDTH - 6)}\u2502 \u2551`);
+            }
+        }
+        lines.push(`\u2551  \u2514${'─'.repeat(BOX_WIDTH - 5)}\u2518 \u2551`);
+    }
+    // Pull section
+    const pullEntries = [
+        ...result.diff.pull_new.map(e => ({ entry: e, tag: 'NEW' })),
+        ...result.diff.pull_update.map(e => ({ entry: e, tag: 'UPDATE' })),
+    ];
+    if (pullEntries.length > 0) {
+        lines.push(`\u2551  ${pad('PULL (Wire \u2192 Local)', BOX_WIDTH - 4)} \u2551`);
+        lines.push(`\u2551  \u250C${'─'.repeat(BOX_WIDTH - 5)}\u2510 \u2551`);
+        for (const { entry, tag } of pullEntries) {
+            const entryLines = formatEntryLine(tag, entry);
+            for (const line of entryLines) {
+                lines.push(`\u2551  \u2502 ${pad(line, BOX_WIDTH - 6)}\u2502 \u2551`);
+            }
+        }
+        lines.push(`\u2551  \u2514${'─'.repeat(BOX_WIDTH - 5)}\u2518 \u2551`);
+    }
+    // Conflicts section
+    if (result.diff.conflicts.length > 0) {
+        lines.push(`\u2551  ${pad('CONFLICTS (require resolution)', BOX_WIDTH - 4)} \u2551`);
+        lines.push(`\u2551  \u250C${'─'.repeat(BOX_WIDTH - 5)}\u2510 \u2551`);
+        for (const entry of result.diff.conflicts) {
+            const entryLines = formatEntryLine('CONFLICT', entry);
+            for (const line of entryLines) {
+                lines.push(`\u2551  \u2502 ${pad(line, BOX_WIDTH - 6)}\u2502 \u2551`);
+            }
+        }
+        lines.push(`\u2551  \u2514${'─'.repeat(BOX_WIDTH - 5)}\u2518 \u2551`);
+    }
+    // Summary
+    const { summary } = result;
+    const parts = [];
+    if (summary.push_new > 0)
+        parts.push(`${summary.push_new} new push${summary.push_new > 1 ? 'es' : ''}`);
+    if (summary.push_update > 0)
+        parts.push(`${summary.push_update} update push${summary.push_update > 1 ? 'es' : ''}`);
+    if (summary.pull_new > 0)
+        parts.push(`${summary.pull_new} new pull${summary.pull_new > 1 ? 's' : ''}`);
+    if (summary.pull_update > 0)
+        parts.push(`${summary.pull_update} update pull${summary.pull_update > 1 ? 's' : ''}`);
+    if (summary.in_sync > 0)
+        parts.push(`${summary.in_sync} in sync`);
+    if (summary.conflicts > 0)
+        parts.push(`${summary.conflicts} conflict${summary.conflicts > 1 ? 's' : ''}`);
+    const summaryText = parts.length > 0 ? `Summary: ${parts.join(', ')}` : 'Summary: nothing to sync';
+    lines.push(`\u2551  ${pad(summaryText, BOX_WIDTH - 4)} \u2551`);
+    // Action line
+    lines.push(`\u2551  ${pad('[A] Sync all  [S] Select individually  [Q] Cancel', BOX_WIDTH - 4)} \u2551`);
+    // Bottom border
+    lines.push(`\u255A${'═'.repeat(BOX_WIDTH)}\u255D`);
+    return lines.join('\n');
+}
+/**
+ * Generate structured JSON preview for programmatic use.
+ */
+export function generatePreviewJson(result) {
+    return {
+        corpus_slug: result.corpus_slug,
+        local_dir: result.local_dir,
+        summary: result.summary,
+        push: {
+            new: result.diff.push_new.map(e => ({
+                path: e.relativePath,
+                size: e.sizeInfo,
+                warnings: e.warnings,
+            })),
+            update: result.diff.push_update.map(e => ({
+                path: e.relativePath,
+                size: e.sizeInfo,
+                remote_id: e.remoteDoc?.id,
+                remote_status: e.remoteDoc?.status,
+                remote_anchored: e.remoteDoc?.anchored,
+                remote_version: e.remoteDoc?.version_number,
+                warnings: e.warnings,
+            })),
+        },
+        pull: {
+            new: result.diff.pull_new.map(e => ({
+                path: e.relativePath,
+                remote_id: e.remoteDoc?.id,
+                remote_status: e.remoteDoc?.status,
+                warnings: e.warnings,
+            })),
+            update: result.diff.pull_update.map(e => ({
+                path: e.relativePath,
+                remote_id: e.remoteDoc?.id,
+                remote_status: e.remoteDoc?.status,
+                warnings: e.warnings,
+            })),
+        },
+        conflicts: result.diff.conflicts.map(e => ({
+            path: e.relativePath,
+            remote_id: e.remoteDoc?.id,
+            remote_status: e.remoteDoc?.status,
+            warnings: e.warnings,
+        })),
+        in_sync: result.diff.in_sync.map(e => ({
+            path: e.relativePath,
+            remote_id: e.remoteDoc?.id,
+        })),
+    };
+}
+//# sourceMappingURL=preview.js.map

package/dist/sync/preview.js.map

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

package/dist/sync/pull.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Pull remote documents to local filesystem.
+ * Node.js only — uses fs/promises.
+ *
+ * Reconstructs directory structure from source_path.
+ * Validates all paths stay within the sync root directory.
+ */
+import type { WireAPI } from '../api.js';
+import type { DiffEntry } from './types.js';
+export interface PullResult {
+    relativePath: string;
+    success: boolean;
+    error?: string;
+}
+/**
+ * Pull remote documents to the local filesystem.
+ *
+ * @param apiClient - Authenticated WireAPI instance
+ * @param syncDir - Local directory to pull files into
+ * @param entries - DiffEntry items to pull (pull_new or pull_update)
+ * @returns Array of pull results per file
+ */
+export declare function pullFiles(apiClient: WireAPI, syncDir: string, entries: DiffEntry[]): Promise<PullResult[]>;

package/dist/sync/pull.js

@@ -0,0 +1,126 @@
+/**
+ * Pull remote documents to local filesystem.
+ * Node.js only — uses fs/promises.
+ *
+ * Reconstructs directory structure from source_path.
+ * Validates all paths stay within the sync root directory.
+ */
+import { writeFile, mkdir } from 'fs/promises';
+import { join, resolve, dirname } from 'path';
+import { statfsSync } from 'fs';
+import { computeHash } from './hash.js';
+/**
+ * Validate that a resolved path is within the sync root.
+ * Prevents path traversal attacks.
+ */
+function validatePathWithinRoot(targetPath, rootDir) {
+    const resolved = resolve(targetPath);
+    const resolvedRoot = resolve(rootDir);
+    return resolved.startsWith(resolvedRoot + '/') || resolved === resolvedRoot;
+}
+/**
+ * Check available disk space (in bytes).
+ * Returns null if unable to determine.
+ */
+function getAvailableDiskSpace(dir) {
+    try {
+        const stats = statfsSync(dir);
+        const availableBytes = stats.bavail * stats.bsize;
+        return availableBytes;
+    }
+    catch {
+        // Ignore
+    }
+    return null;
+}
+const MIN_DISK_SPACE_BYTES = 100 * 1024 * 1024; // 100 MB
+/**
+ * Pull remote documents to the local filesystem.
+ *
+ * @param apiClient - Authenticated WireAPI instance
+ * @param syncDir - Local directory to pull files into
+ * @param entries - DiffEntry items to pull (pull_new or pull_update)
+ * @returns Array of pull results per file
+ */
+export async function pullFiles(apiClient, syncDir, entries) {
+    const rootDir = resolve(syncDir);
+    const results = [];
+    if (entries.length === 0) {
+        return results;
+    }
+    // Check disk space before starting
+    const availableSpace = getAvailableDiskSpace(rootDir);
+    if (availableSpace !== null && availableSpace < MIN_DISK_SPACE_BYTES) {
+        const availableMB = (availableSpace / (1024 * 1024)).toFixed(1);
+        return entries.map(e => ({
+            relativePath: e.relativePath,
+            success: false,
+            error: `Insufficient disk space: ${availableMB} MB available, need at least 100 MB`,
+        }));
+    }
+    for (const entry of entries) {
+        try {
+            if (!entry.remoteDoc) {
+                results.push({
+                    relativePath: entry.relativePath,
+                    success: false,
+                    error: 'No remote document reference available',
+                });
+                continue;
+            }
+            // Determine local file path
+            const relPath = entry.relativePath;
+            // Validate the path stays within sync root
+            const targetPath = join(rootDir, relPath);
+            if (!validatePathWithinRoot(targetPath, rootDir)) {
+                results.push({
+                    relativePath: relPath,
+                    success: false,
+                    error: `Path escapes sync root: ${relPath}`,
+                });
+                continue;
+            }
+            // Fetch full document content from API
+            const doc = await apiClient.readDocument(entry.remoteDoc.id);
+            const content = doc.body || doc.content || '';
+            if (!content) {
+                results.push({
+                    relativePath: relPath,
+                    success: false,
+                    error: 'Remote document has no body content',
+                });
+                continue;
+            }
+            // Verify downloaded content hash matches expected hash
+            if (entry.remoteDoc.body_hash) {
+                const downloadedHash = await computeHash(content);
+                if (downloadedHash !== entry.remoteDoc.body_hash) {
+                    results.push({
+                        relativePath: relPath,
+                        success: false,
+                        error: `Hash mismatch: expected ${entry.remoteDoc.body_hash}, got ${downloadedHash}`,
+                    });
+                    continue;
+                }
+            }
+            // Create directory structure
+            const targetDir = dirname(targetPath);
+            await mkdir(targetDir, { recursive: true });
+            // Write file
+            await writeFile(targetPath, content, 'utf-8');
+            results.push({
+                relativePath: relPath,
+                success: true,
+            });
+        }
+        catch (err) {
+            results.push({
+                relativePath: entry.relativePath,
+                success: false,
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=pull.js.map

package/dist/sync/pull.js.map

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

package/dist/sync/push.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Push local files to Wire.
+ * Requires WireAPI client — uses HTTP calls, not fs.
+ *
+ * Strategy:
+ * - push_new: POST to create document with source_path set
+ * - push_update (draft): PATCH to update body directly
+ * - push_update (published): call createDocumentVersion RPC to atomically create a new version
+ */
+import type { WireAPI } from '../api.js';
+import type { DiffEntry } from './types.js';
+export interface PushResult {
+    relativePath: string;
+    documentId: string;
+    success: boolean;
+    error?: string;
+}
+/**
+ * Push local files to the Wire corpus.
+ *
+ * @param apiClient - Authenticated WireAPI instance
+ * @param corpusSlug - The corpus slug to push to
+ * @param entries - DiffEntry items to push (push_new or push_update)
+ * @param publish - Whether to publish immediately (default: false, creates as draft)
+ * @returns Array of push results per file
+ */
+export declare function pushFiles(apiClient: WireAPI, corpusSlug: string, entries: DiffEntry[], publish?: boolean): Promise<PushResult[]>;