pushwork 1.1.4 → 2.0.0-a.sub.1

package/dist/commands.js

@@ -1,82 +1,32 @@
-"use strict";
-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;
-    };
-})();
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.init = init;
-exports.sync = sync;
-exports.diff = diff;
-exports.status = status;
-exports.log = log;
-exports.checkout = checkout;
-exports.clone = clone;
-exports.url = url;
-exports.rm = rm;
-exports.commit = commit;
-exports.ls = ls;
-exports.config = config;
-exports.watch = watch;
-exports.root = root;
-const path = __importStar(require("path"));
-const fs = __importStar(require("fs/promises"));
-const fsSync = __importStar(require("fs"));
-const diffLib = __importStar(require("diff"));
-const child_process_1 = require("child_process");
-const core_1 = require("./core");
-const utils_1 = require("./utils");
-const config_1 = require("./core/config");
-const repo_factory_1 = require("./utils/repo-factory");
-const output_1 = require("./utils/output");
-const network_sync_1 = require("./utils/network-sync");
-const chalk_1 = __importDefault(require("chalk"));
+import * as path from "path";
+import * as fs from "fs/promises";
+import * as fsSync from "fs";
+import * as diffLib from "diff";
+import { spawn } from "child_process";
+import { SyncEngine } from "./core/index.js";
+import { pathExists, ensureDirectoryExists, formatRelativePath } from "./utils/index.js";
+import { ConfigManager } from "./core/config.js";
+import { createRepo, createEphemeralRepo } from "./utils/repo-factory.js";
+import { out } from "./utils/output.js";
+import { waitForSync } from "./utils/network-sync.js";
+import { readDocContent } from "./utils/text-diff.js";
+import { DEFAULT_SYNC_SERVER } from "./types/config.js";
+import chalk from "chalk";
 /**
  * Initialize repository directory structure and configuration
  * Shared logic for init and clone commands
  */
 async function initializeRepository(resolvedPath, overrides) {
     // Create .pushwork directory structure
-    const syncToolDir = path.join(resolvedPath, config_1.ConfigManager.CONFIG_DIR);
-    await (0, utils_1.ensureDirectoryExists)(syncToolDir);
-    await (0, utils_1.ensureDirectoryExists)(path.join(syncToolDir, "automerge"));
+    const syncToolDir = path.join(resolvedPath, ConfigManager.CONFIG_DIR);
+    await ensureDirectoryExists(syncToolDir);
+    await ensureDirectoryExists(path.join(syncToolDir, "automerge"));
     // Create configuration with overrides
-    const configManager = new config_1.ConfigManager(resolvedPath);
+    const configManager = new ConfigManager(resolvedPath);
     const config = await configManager.initializeWithOverrides(overrides);
     // Create repository and sync engine
-    const repo = await (0, repo_factory_1.createRepo)(resolvedPath, config);
-    const syncEngine = new core_1.SyncEngine(repo, resolvedPath, config);
+    const repo = await createRepo(resolvedPath, config);
+    const syncEngine = new SyncEngine(repo, resolvedPath, config);
     return { config, repo, syncEngine };
 }
 /**
@@ -86,12 +36,12 @@ async function initializeRepository(resolvedPath, overrides) {
 async function setupCommandContext(workingDir = process.cwd(), options) {
     const resolvedPath = path.resolve(workingDir);
     // Check if initialized
-    const syncToolDir = path.join(resolvedPath, config_1.ConfigManager.CONFIG_DIR);
-    if (!(await (0, utils_1.pathExists)(syncToolDir))) {
+    const syncToolDir = path.join(resolvedPath, ConfigManager.CONFIG_DIR);
+    if (!(await pathExists(syncToolDir))) {
         throw new Error('Directory not initialized for sync. Run "pushwork init" first.');
     }
     // Load configuration
-    const configManager = new config_1.ConfigManager(resolvedPath);
+    const configManager = new ConfigManager(resolvedPath);
     let config;
     if (options?.forceDefaults) {
         // Force mode: use defaults, only preserving root_directory_url from local config
@@ -109,9 +59,9 @@ async function setupCommandContext(workingDir = process.cwd(), options) {
         config = { ...config, sync_enabled: options.syncEnabled };
     }
     // Create repo with config
-    const repo = await (0, repo_factory_1.createRepo)(resolvedPath, config);
+    const repo = await createRepo(resolvedPath, config);
     // Create sync engine
-    const syncEngine = new core_1.SyncEngine(repo, resolvedPath, config);
+    const syncEngine = new SyncEngine(repo, resolvedPath, config);
     return {
         repo,
         syncEngine,
@@ -156,24 +106,23 @@ async function safeRepoShutdown(repo) {
 /**
  * Initialize sync in a directory
  */
-async function init(targetPath, options = {}) {
+export async function init(targetPath, options = {}) {
     const resolvedPath = path.resolve(targetPath);
-    output_1.out.task(`Initializing`);
-    await (0, utils_1.ensureDirectoryExists)(resolvedPath);
+    out.task(`Initializing`);
+    await ensureDirectoryExists(resolvedPath);
     // Check if already initialized
-    const syncToolDir = path.join(resolvedPath, config_1.ConfigManager.CONFIG_DIR);
-    if (await (0, utils_1.pathExists)(syncToolDir)) {
-        output_1.out.error("Directory already initialized for sync");
-        output_1.out.exit(1);
+    const syncToolDir = path.join(resolvedPath, ConfigManager.CONFIG_DIR);
+    if (await pathExists(syncToolDir)) {
+        out.error("Directory already initialized for sync");
+        out.exit(1);
     }
     // Initialize repository with optional CLI overrides
-    output_1.out.update("Setting up repository");
+    out.update("Setting up repository");
     const { repo, syncEngine, config } = await initializeRepository(resolvedPath, {
         sync_server: options.syncServer,
-        sync_server_storage_id: options.syncServerStorageId,
     });
     // Create new root directory document
-    output_1.out.update("Creating root directory");
+    out.update("Creating root directory");
     const dirName = path.basename(resolvedPath);
     const rootDoc = {
         "@patchwork": { type: "folder" },
@@ -187,31 +136,31 @@ async function init(targetPath, options = {}) {
     // Wait for root document to sync to server if sync is enabled
     // This ensures the document is uploaded before we exit
     // waitForSync() verifies the server has the document by comparing local and remote heads
-    if (config.sync_enabled && config.sync_server_storage_id) {
-        output_1.out.update("Syncing to server");
-        const { failed } = await (0, network_sync_1.waitForSync)([rootHandle], config.sync_server_storage_id);
+    if (config.sync_enabled && config.sync_server) {
+        out.update("Syncing to server");
+        const { failed } = await waitForSync([rootHandle]);
         if (failed.length > 0) {
-            output_1.out.taskLine("Root document failed to sync to server", true);
+            out.taskLine("Root document failed to sync to server", true);
             // Continue anyway - the document is created locally and will sync later
         }
     }
     // Run initial sync to capture existing files
-    output_1.out.update("Running initial sync");
+    out.update("Running initial sync");
     const result = await syncEngine.sync();
-    output_1.out.update("Writing to disk");
+    out.update("Writing to disk");
     await safeRepoShutdown(repo);
-    output_1.out.done("Initialized");
-    output_1.out.successBlock("INITIALIZED", rootHandle.url);
+    out.done("Initialized");
+    out.successBlock("INITIALIZED", rootHandle.url);
     if (result.filesChanged > 0) {
-        output_1.out.info(`Synced ${result.filesChanged} ${plural("file", result.filesChanged)}`);
+        out.info(`Synced ${result.filesChanged} ${plural("file", result.filesChanged)}`);
     }
     process.exit();
 }
 /**
  * Run bidirectional sync
  */
-async function sync(targetPath = ".", options) {
-    output_1.out.task(options.nuclear
+export async function sync(targetPath = ".", options) {
+    out.task(options.nuclear
         ? "Nuclear syncing"
         : options.gentle
             ? "Gentle syncing"
@@ -223,78 +172,78 @@ async function sync(targetPath = ".", options) {
         await syncEngine.nuclearReset();
     }
     if (options.dryRun) {
-        output_1.out.update("Analyzing changes");
+        out.update("Analyzing changes");
         const preview = await syncEngine.previewChanges();
         if (preview.changes.length === 0 && preview.moves.length === 0) {
-            output_1.out.done("Already synced");
+            out.done("Already synced");
             return;
         }
-        output_1.out.done();
-        output_1.out.infoBlock("CHANGES");
-        output_1.out.obj({
+        out.done();
+        out.infoBlock("CHANGES");
+        out.obj({
             Changes: preview.changes.length.toString(),
             Moves: preview.moves.length > 0 ? preview.moves.length.toString() : undefined,
         });
-        output_1.out.log("");
-        output_1.out.log("Files:");
+        out.log("");
+        out.log("Files:");
         for (const change of preview.changes.slice(0, 10)) {
             const prefix = change.changeType === "local_only"
                 ? "[local]  "
                 : change.changeType === "remote_only"
                     ? "[remote] "
                     : "[conflict]";
-            output_1.out.log(`  ${prefix} ${change.path}`);
+            out.log(`  ${prefix} ${change.path}`);
         }
         if (preview.changes.length > 10) {
-            output_1.out.log(`  ... and ${preview.changes.length - 10} more`);
+            out.log(`  ... and ${preview.changes.length - 10} more`);
         }
         if (preview.moves.length > 0) {
-            output_1.out.log("");
-            output_1.out.log("Moves:");
+            out.log("");
+            out.log("Moves:");
             for (const move of preview.moves.slice(0, 5)) {
-                output_1.out.log(`  ${move.fromPath} → ${move.toPath}`);
+                out.log(`  ${move.fromPath} → ${move.toPath}`);
             }
             if (preview.moves.length > 5) {
-                output_1.out.log(`  ... and ${preview.moves.length - 5} more`);
+                out.log(`  ... and ${preview.moves.length - 5} more`);
             }
         }
-        output_1.out.log("");
-        output_1.out.log("Run without --dry-run to apply these changes");
+        out.log("");
+        out.log("Run without --dry-run to apply these changes");
     }
     else {
         const result = await syncEngine.sync();
-        output_1.out.taskLine("Writing to disk");
+        out.taskLine("Writing to disk");
         await safeRepoShutdown(repo);
         if (result.success) {
-            output_1.out.done("Synced");
+            out.done("Synced");
             if (result.filesChanged === 0 && result.directoriesChanged === 0) {
             }
             else {
-                output_1.out.successBlock("SYNCED", `${result.filesChanged} ${plural("file", result.filesChanged)}`);
+                out.successBlock("SYNCED", `${result.filesChanged} ${plural("file", result.filesChanged)}`);
             }
             if (result.warnings.length > 0) {
-                output_1.out.log("");
-                output_1.out.warnBlock("WARNINGS", `${result.warnings.length} warnings`);
+                out.log("");
+                out.warnBlock("WARNINGS", `${result.warnings.length} warnings`);
                 for (const warning of result.warnings.slice(0, 5)) {
-                    output_1.out.log(`  ${warning}`);
+                    out.log(`  ${warning}`);
                 }
                 if (result.warnings.length > 5) {
-                    output_1.out.log(`  ... and ${result.warnings.length - 5} more`);
+                    out.log(`  ... and ${result.warnings.length - 5} more`);
                 }
             }
         }
         else {
-            output_1.out.done("partial", false);
-            output_1.out.warnBlock("PARTIAL", `${result.filesChanged} updated, ${result.errors.length} errors`);
-            output_1.out.obj({
+            out.done("partial", false);
+            out.warnBlock("PARTIAL", `${result.filesChanged} updated, ${result.errors.length} errors`);
+            out.obj({
                 Files: result.filesChanged,
                 Errors: result.errors.length,
             });
             result.errors
                 .slice(0, 5)
-                .forEach((error) => output_1.out.error(`${error.path}: ${error.error.message}`));
+                .forEach((error) => out.error(`${error.path}: ${error.error.message}`));
             if (result.errors.length > 5) {
-                output_1.out.warn(`... and ${result.errors.length - 5} more errors`);
+                out.warn(`... and ${result.errors.length - 5} more errors`);
             }
         }
     }
@@ -303,24 +252,24 @@ async function sync(targetPath = ".", options) {
 /**
  * Show differences between local and remote
  */
-async function diff(targetPath = ".", options) {
-    output_1.out.task("Analyzing changes");
+export async function diff(targetPath = ".", options) {
+    out.task("Analyzing changes");
     const { repo, syncEngine } = await setupCommandContext(targetPath, { syncEnabled: false });
     const preview = await syncEngine.previewChanges();
-    output_1.out.done();
+    out.done();
     if (options.nameOnly) {
         for (const change of preview.changes) {
-            output_1.out.log(change.path);
+            out.log(change.path);
         }
         return;
     }
     if (preview.changes.length === 0) {
-        output_1.out.success("No changes detected");
+        out.success("No changes detected");
         await safeRepoShutdown(repo);
-        output_1.out.exit();
+        out.exit();
         return;
     }
-    output_1.out.warn(`${preview.changes.length} changes detected`);
+    out.warn(`${preview.changes.length} changes detected`);
     for (const change of preview.changes) {
         const prefix = change.changeType === "local_only"
             ? "[local]  "
@@ -344,7 +293,7 @@ async function diff(targetPath = ".", options) {
             // Skip the header lines and process the diff
             const lines = diffResult.split("\n").slice(4); // Skip index, ===, ---, +++ lines
             if (lines.length === 0 || (lines.length === 1 && lines[0] === "")) {
-                output_1.out.log(`${prefix}${change.path} (content identical)`, "cyan");
+                out.log(`${prefix}${change.path} (content identical)`, "cyan");
                 continue;
             }
             // Extract first hunk header and show inline with path
@@ -354,28 +303,28 @@ async function diff(targetPath = ".", options) {
                 firstHunk = ` ${lines[0]}`;
                 diffLines = lines.slice(1);
             }
-            output_1.out.log(`${prefix}${change.path}${firstHunk}`, "cyan");
+            out.log(`${prefix}${change.path}${firstHunk}`, "cyan");
             for (const line of diffLines) {
                 if (line.startsWith("@@")) {
                     // Additional hunk headers
-                    output_1.out.log(line, "dim");
+                    out.log(line, "dim");
                 }
                 else if (line.startsWith("+")) {
                     // Added line
-                    output_1.out.log(line, "green");
+                    out.log(line, "green");
                 }
                 else if (line.startsWith("-")) {
                     // Removed line
-                    output_1.out.log(line, "red");
+                    out.log(line, "red");
                 }
                 else if (line.startsWith(" ") || line === "") {
                     // Context line or empty
-                    output_1.out.log(line, "dim");
+                    out.log(line, "dim");
                 }
             }
         }
         catch (error) {
-            output_1.out.log(`${prefix}${change.path} (diff error: ${error})`, "cyan");
+            out.log(`${prefix}${change.path} (diff error: ${error})`, "cyan");
         }
     }
     await safeRepoShutdown(repo);
@@ -383,10 +332,10 @@ async function diff(targetPath = ".", options) {
 /**
  * Show sync status
  */
-async function status(targetPath = ".", options = {}) {
+export async function status(targetPath = ".", options = {}) {
     const { repo, syncEngine, config } = await setupCommandContext(targetPath, { syncEnabled: false });
     const syncStatus = await syncEngine.getStatus();
-    output_1.out.infoBlock("STATUS");
+    out.infoBlock("STATUS");
     const statusInfo = {};
     const fileCount = syncStatus.snapshot?.files.size || 0;
     statusInfo["URL"] = syncStatus.snapshot?.rootDirectoryUrl;
@@ -409,61 +358,61 @@ async function status(targetPath = ".", options = {}) {
             }
         }
         catch (error) {
-            output_1.out.warn(`Warning: Could not load detailed info: ${error}`);
+            out.warn(`Warning: Could not load detailed info: ${error}`);
         }
     }
     statusInfo["Changes"] = syncStatus.hasChanges
         ? `${syncStatus.changeCount} pending`
         : undefined;
     statusInfo["Status"] = !syncStatus.hasChanges ? "up to date" : undefined;
-    output_1.out.obj(statusInfo);
+    out.obj(statusInfo);
     // Show verbose details if requested
     if (options.verbose && syncStatus.snapshot?.rootDirectoryUrl) {
         const rootHandle = await repo.find(syncStatus.snapshot.rootDirectoryUrl);
         const rootDoc = await rootHandle.doc();
         if (rootDoc) {
-            output_1.out.infoBlock("HEADS");
-            output_1.out.arr(rootHandle.heads());
+            out.infoBlock("HEADS");
+            out.arr(rootHandle.heads());
             if (syncStatus.snapshot && syncStatus.snapshot.files.size > 0) {
-                output_1.out.infoBlock("TRACKED FILES");
+                out.infoBlock("TRACKED FILES");
                 const filesObj = {};
                 syncStatus.snapshot.files.forEach((entry, filePath) => {
                     filesObj[filePath] = entry.url;
                 });
-                output_1.out.obj(filesObj);
+                out.obj(filesObj);
             }
         }
     }
     if (syncStatus.hasChanges && !options.verbose) {
-        output_1.out.info("Run 'pushwork diff' to see changes");
+        out.info("Run 'pushwork diff' to see changes");
     }
     await safeRepoShutdown(repo);
 }
 /**
  * Show sync history
  */
-async function log(targetPath = ".", _options) {
+export async function log(targetPath = ".", _options) {
     const { repo: logRepo, workingDir } = await setupCommandContext(targetPath, { syncEnabled: false });
     // TODO: Implement history tracking
-    const snapshotPath = path.join(workingDir, config_1.ConfigManager.CONFIG_DIR, "snapshot.json");
-    if (await (0, utils_1.pathExists)(snapshotPath)) {
+    const snapshotPath = path.join(workingDir, ConfigManager.CONFIG_DIR, "snapshot.json");
+    if (await pathExists(snapshotPath)) {
         const stats = await fs.stat(snapshotPath);
-        output_1.out.infoBlock("HISTORY", "Sync history (stub)");
-        output_1.out.obj({ "Last sync": stats.mtime.toISOString() });
+        out.infoBlock("HISTORY", "Sync history (stub)");
+        out.obj({ "Last sync": stats.mtime.toISOString() });
     }
     else {
-        output_1.out.info("No sync history found");
+        out.info("No sync history found");
     }
     await safeRepoShutdown(logRepo);
 }
 /**
  * Checkout/restore from previous sync
  */
-async function checkout(syncId, targetPath = ".", _options) {
+export async function checkout(syncId, targetPath = ".", _options) {
     const { workingDir } = await setupCommandContext(targetPath);
     // TODO: Implement checkout functionality
-    output_1.out.warnBlock("NOT IMPLEMENTED", "Checkout not yet implemented");
-    output_1.out.obj({
+    out.warnBlock("NOT IMPLEMENTED", "Checkout not yet implemented");
+    out.obj({
         "Sync ID": syncId,
         Path: workingDir,
     });
@@ -471,150 +420,149 @@ async function checkout(syncId, targetPath = ".", _options) {
 /**
  * Clone an existing synced directory from an AutomergeUrl
  */
-async function clone(rootUrl, targetPath, options) {
+export async function clone(rootUrl, targetPath, options) {
     // Validate that rootUrl is actually an Automerge URL
     if (!rootUrl.startsWith("automerge:")) {
-        output_1.out.error(`Invalid Automerge URL: ${rootUrl}\n` +
+        out.error(`Invalid Automerge URL: ${rootUrl}\n` +
             `Expected format: automerge:XXXXX\n` +
             `Usage: pushwork clone <automerge-url> <path>`);
-        output_1.out.exit(1);
+        out.exit(1);
     }
     const resolvedPath = path.resolve(targetPath);
-    output_1.out.task(`Cloning ${rootUrl}`);
+    out.task(`Cloning ${rootUrl}`);
     // Check if directory exists and handle --force
-    if (await (0, utils_1.pathExists)(resolvedPath)) {
+    if (await pathExists(resolvedPath)) {
         const files = await fs.readdir(resolvedPath);
         if (files.length > 0 && !options.force) {
-            output_1.out.error("Target directory is not empty. Use --force to overwrite");
-            output_1.out.exit(1);
+            out.error("Target directory is not empty. Use --force to overwrite");
+            out.exit(1);
         }
     }
     else {
-        await (0, utils_1.ensureDirectoryExists)(resolvedPath);
+        await ensureDirectoryExists(resolvedPath);
     }
     // Check if already initialized
-    const syncToolDir = path.join(resolvedPath, config_1.ConfigManager.CONFIG_DIR);
-    if (await (0, utils_1.pathExists)(syncToolDir)) {
+    const syncToolDir = path.join(resolvedPath, ConfigManager.CONFIG_DIR);
+    if (await pathExists(syncToolDir)) {
         if (!options.force) {
-            output_1.out.error("Directory already initialized. Use --force to overwrite");
-            output_1.out.exit(1);
+            out.error("Directory already initialized. Use --force to overwrite");
+            out.exit(1);
         }
         await fs.rm(syncToolDir, { recursive: true, force: true });
     }
     // Initialize repository with optional CLI overrides
-    output_1.out.update("Setting up repository");
+    out.update("Setting up repository");
     const { config, repo, syncEngine } = await initializeRepository(resolvedPath, {
         sync_server: options.syncServer,
-        sync_server_storage_id: options.syncServerStorageId,
     });
     // Connect to existing root directory and download files
-    output_1.out.update("Downloading files");
+    out.update("Downloading files");
     await syncEngine.setRootDirectoryUrl(rootUrl);
     const result = await syncEngine.sync();
-    output_1.out.update("Writing to disk");
+    out.update("Writing to disk");
     await safeRepoShutdown(repo);
-    output_1.out.done();
-    output_1.out.obj({
+    out.done();
+    out.obj({
         Path: resolvedPath,
         Files: `${result.filesChanged} downloaded`,
         Sync: config.sync_server,
     });
-    output_1.out.successBlock("CLONED", rootUrl);
+    out.successBlock("CLONED", rootUrl);
     process.exit();
 }
 /**
  * Get the root URL for the current pushwork repository
  */
-async function url(targetPath = ".") {
+export async function url(targetPath = ".") {
     const resolvedPath = path.resolve(targetPath);
-    const syncToolDir = path.join(resolvedPath, config_1.ConfigManager.CONFIG_DIR);
-    if (!(await (0, utils_1.pathExists)(syncToolDir))) {
-        output_1.out.error("Directory not initialized for sync");
-        output_1.out.exit(1);
+    const syncToolDir = path.join(resolvedPath, ConfigManager.CONFIG_DIR);
+    if (!(await pathExists(syncToolDir))) {
+        out.error("Directory not initialized for sync");
+        out.exit(1);
     }
     const snapshotPath = path.join(syncToolDir, "snapshot.json");
-    if (!(await (0, utils_1.pathExists)(snapshotPath))) {
-        output_1.out.error("No snapshot found");
-        output_1.out.exit(1);
+    if (!(await pathExists(snapshotPath))) {
+        out.error("No snapshot found");
+        out.exit(1);
     }
     const snapshotData = await fs.readFile(snapshotPath, "utf-8");
     const snapshot = JSON.parse(snapshotData);
     if (snapshot.rootDirectoryUrl) {
         // Output just the URL for easy use in scripts
-        output_1.out.log(snapshot.rootDirectoryUrl);
+        out.log(snapshot.rootDirectoryUrl);
     }
     else {
-        output_1.out.error("No root URL found in snapshot");
-        output_1.out.exit(1);
+        out.error("No root URL found in snapshot");
+        out.exit(1);
     }
 }
 /**
  * Remove local pushwork data and log URL for recovery
  */
-async function rm(targetPath = ".") {
+export async function rm(targetPath = ".") {
     const resolvedPath = path.resolve(targetPath);
-    const syncToolDir = path.join(resolvedPath, config_1.ConfigManager.CONFIG_DIR);
-    if (!(await (0, utils_1.pathExists)(syncToolDir))) {
-        output_1.out.error("Directory not initialized for sync");
-        output_1.out.exit(1);
+    const syncToolDir = path.join(resolvedPath, ConfigManager.CONFIG_DIR);
+    if (!(await pathExists(syncToolDir))) {
+        out.error("Directory not initialized for sync");
+        out.exit(1);
     }
     // Read the URL before deletion for recovery
     let recoveryUrl = "";
     const snapshotPath = path.join(syncToolDir, "snapshot.json");
-    if (await (0, utils_1.pathExists)(snapshotPath)) {
+    if (await pathExists(snapshotPath)) {
         try {
             const snapshotData = await fs.readFile(snapshotPath, "utf-8");
             const snapshot = JSON.parse(snapshotData);
             recoveryUrl = snapshot.rootDirectoryUrl || null;
         }
         catch (error) {
-            output_1.out.error(`Remove failed: ${error}`);
-            output_1.out.exit(1);
+            out.error(`Remove failed: ${error}`);
+            out.exit(1);
             return;
         }
     }
-    output_1.out.task("Removing local pushwork data");
+    out.task("Removing local pushwork data");
     await fs.rm(syncToolDir, { recursive: true, force: true });
-    output_1.out.done();
-    output_1.out.warnBlock("REMOVED", recoveryUrl);
+    out.done();
+    out.warnBlock("REMOVED", recoveryUrl);
     process.exit();
 }
-async function commit(targetPath, _options = {}) {
-    output_1.out.task("Committing local changes");
+export async function commit(targetPath, _options = {}) {
+    out.task("Committing local changes");
     const { repo, syncEngine } = await setupCommandContext(targetPath, { syncEnabled: false });
     const result = await syncEngine.commitLocal();
     await safeRepoShutdown(repo);
-    output_1.out.done();
+    out.done();
     if (result.errors.length > 0) {
-        output_1.out.errorBlock("ERROR", `${result.errors.length} errors`);
-        result.errors.forEach((error) => output_1.out.error(error));
-        output_1.out.exit(1);
+        out.errorBlock("ERROR", `${result.errors.length} errors`);
+        result.errors.forEach((error) => out.error(error));
+        out.exit(1);
     }
-    output_1.out.successBlock("COMMITTED", `${result.filesChanged} files`);
-    output_1.out.obj({
+    out.successBlock("COMMITTED", `${result.filesChanged} files`);
+    out.obj({
         Files: result.filesChanged,
         Directories: result.directoriesChanged,
     });
     if (result.warnings.length > 0) {
-        result.warnings.forEach((warning) => output_1.out.warn(warning));
+        result.warnings.forEach((warning) => out.warn(warning));
     }
     process.exit();
 }
 /**
  * List tracked files
  */
-async function ls(targetPath = ".", options = {}) {
+export async function ls(targetPath = ".", options = {}) {
     const { repo, syncEngine } = await setupCommandContext(targetPath, { syncEnabled: false });
     const syncStatus = await syncEngine.getStatus();
     if (!syncStatus.snapshot) {
-        output_1.out.error("No snapshot found");
+        out.error("No snapshot found");
         await safeRepoShutdown(repo);
-        output_1.out.exit(1);
+        out.exit(1);
         return;
     }
     const files = Array.from(syncStatus.snapshot.files.entries()).sort(([pathA], [pathB]) => pathA.localeCompare(pathB));
     if (files.length === 0) {
-        output_1.out.info("No tracked files");
+        out.info("No tracked files");
         await safeRepoShutdown(repo);
         return;
     }
@@ -622,13 +570,13 @@ async function ls(targetPath = ".", options = {}) {
         // Long format with URLs
         for (const [filePath, entry] of files) {
             const url = entry?.url || "unknown";
-            output_1.out.log(`${filePath} -> ${url}`);
+            out.log(`${filePath} -> ${url}`);
         }
     }
     else {
         // Simple list
         for (const [filePath] of files) {
-            output_1.out.log(filePath);
+            out.log(filePath);
         }
     }
     await safeRepoShutdown(repo);
@@ -636,19 +584,19 @@ async function ls(targetPath = ".", options = {}) {
 /**
  * View or edit configuration
  */
-async function config(targetPath = ".", options = {}) {
+export async function config(targetPath = ".", options = {}) {
     const resolvedPath = path.resolve(targetPath);
-    const syncToolDir = path.join(resolvedPath, config_1.ConfigManager.CONFIG_DIR);
-    if (!(await (0, utils_1.pathExists)(syncToolDir))) {
-        output_1.out.error("Directory not initialized for sync");
-        output_1.out.exit(1);
+    const syncToolDir = path.join(resolvedPath, ConfigManager.CONFIG_DIR);
+    if (!(await pathExists(syncToolDir))) {
+        out.error("Directory not initialized for sync");
+        out.exit(1);
     }
-    const configManager = new config_1.ConfigManager(resolvedPath);
+    const configManager = new ConfigManager(resolvedPath);
     const config = await configManager.getMerged();
     if (options.list) {
         // List all configuration
-        output_1.out.infoBlock("CONFIGURATION", "Full configuration");
-        output_1.out.log(JSON.stringify(config, null, 2));
+        out.infoBlock("CONFIGURATION", "Full configuration");
+        out.log(JSON.stringify(config, null, 2));
     }
     else if (options.get) {
         // Get specific config value
@@ -658,44 +606,44 @@ async function config(targetPath = ".", options = {}) {
             value = value?.[key];
         }
         if (value !== undefined) {
-            output_1.out.log(typeof value === "object" ? JSON.stringify(value, null, 2) : value);
+            out.log(typeof value === "object" ? JSON.stringify(value, null, 2) : value);
         }
         else {
-            output_1.out.error(`Config key not found: ${options.get}`);
-            output_1.out.exit(1);
+            out.error(`Config key not found: ${options.get}`);
+            out.exit(1);
         }
     }
     else {
         // Show basic config info
-        output_1.out.infoBlock("CONFIGURATION");
-        output_1.out.obj({
+        out.infoBlock("CONFIGURATION");
+        out.obj({
             "Sync server": config.sync_server || "default",
             "Sync enabled": config.sync_enabled ? "yes" : "no",
             Exclusions: config.exclude_patterns?.length,
         });
-        output_1.out.log("");
-        output_1.out.log("Use --list to see full configuration");
+        out.log("");
+        out.log("Use --list to see full configuration");
     }
 }
 /**
  * Watch a directory and sync after build script completes
  */
-async function watch(targetPath = ".", options = {}) {
+export async function watch(targetPath = ".", options = {}) {
     const script = options.script || "pnpm build";
     const watchDir = options.watchDir || "src"; // Default to watching 'src' directory
     const verbose = options.verbose || false;
     const { repo, syncEngine, workingDir } = await setupCommandContext(targetPath);
     const absoluteWatchDir = path.resolve(workingDir, watchDir);
     // Check if watch directory exists
-    if (!(await (0, utils_1.pathExists)(absoluteWatchDir))) {
-        output_1.out.error(`Watch directory does not exist: ${watchDir}`);
+    if (!(await pathExists(absoluteWatchDir))) {
+        out.error(`Watch directory does not exist: ${watchDir}`);
         await safeRepoShutdown(repo);
-        output_1.out.exit(1);
+        out.exit(1);
         return;
     }
-    output_1.out.spicyBlock("WATCHING", `${chalk_1.default.underline((0, utils_1.formatRelativePath)(watchDir))} for changes...`);
-    output_1.out.info(`Build script: ${script}`);
-    output_1.out.info(`Working directory: ${workingDir}`);
+    out.spicyBlock("WATCHING", `${chalk.underline(formatRelativePath(watchDir))} for changes...`);
+    out.info(`Build script: ${script}`);
+    out.info(`Working directory: ${workingDir}`);
     let isProcessing = false;
     let pendingChange = false;
     // Function to run build and sync
@@ -707,14 +655,14 @@ async function watch(targetPath = ".", options = {}) {
         isProcessing = true;
         pendingChange = false;
         try {
-            output_1.out.spicy(`[${new Date().toLocaleTimeString()}] Changes detected...`);
+            out.spicy(`[${new Date().toLocaleTimeString()}] Changes detected...`);
             // Run build script
             const buildResult = await runScript(script, workingDir, verbose);
             if (!buildResult.success) {
-                output_1.out.warn("Build script failed");
+                out.warn("Build script failed");
                 if (buildResult.output) {
-                    output_1.out.log("");
-                    output_1.out.log(buildResult.output);
+                    out.log("");
+                    out.log(buildResult.output);
                 }
                 isProcessing = false;
                 if (pendingChange) {
@@ -722,38 +670,38 @@ async function watch(targetPath = ".", options = {}) {
                 }
                 return;
             }
-            output_1.out.info("Build completed...");
+            out.info("Build completed...");
             // Run sync
-            output_1.out.task("Syncing");
+            out.task("Syncing");
             const result = await syncEngine.sync();
             if (result.success) {
                 if (result.filesChanged === 0 && result.directoriesChanged === 0) {
-                    output_1.out.done("Already synced");
+                    out.done("Already synced");
                 }
                 else {
-                    output_1.out.done(`Synced ${result.filesChanged} ${plural("file", result.filesChanged)}`);
+                    out.done(`Synced ${result.filesChanged} ${plural("file", result.filesChanged)}`);
                 }
             }
             else {
-                output_1.out.warn(`⚠ Partial sync: ${result.filesChanged} updated, ${result.errors.length} errors`);
+                out.warn(`⚠ Partial sync: ${result.filesChanged} updated, ${result.errors.length} errors`);
                 result.errors
                     .slice(0, 3)
-                    .forEach((error) => output_1.out.error(`  ${error.path}: ${error.error.message}`));
+                    .forEach((error) => out.error(`  ${error.path}: ${error.error.message}`));
                 if (result.errors.length > 3) {
-                    output_1.out.warn(`  ... and ${result.errors.length - 3} more errors`);
+                    out.warn(`  ... and ${result.errors.length - 3} more errors`);
                 }
             }
             if (result.warnings.length > 0) {
                 result.warnings
                     .slice(0, 3)
-                    .forEach((warning) => output_1.out.warn(`  ${warning}`));
+                    .forEach((warning) => out.warn(`  ${warning}`));
                 if (result.warnings.length > 3) {
-                    output_1.out.warn(`  ... and ${result.warnings.length - 3} more warnings`);
+                    out.warn(`  ... and ${result.warnings.length - 3} more warnings`);
                 }
             }
         }
         catch (error) {
-            output_1.out.error(`Error during build/sync: ${error}`);
+            out.error(`Error during build/sync: ${error}`);
         }
         finally {
             isProcessing = false;
@@ -771,11 +719,11 @@ async function watch(targetPath = ".", options = {}) {
     });
     // Handle graceful shutdown
     const shutdown = async () => {
-        output_1.out.log("");
-        output_1.out.info("Shutting down...");
+        out.log("");
+        out.info("Shutting down...");
         watcher.close();
         await safeRepoShutdown(repo);
-        output_1.out.rainbow("Goodbye!");
+        out.rainbow("Goodbye!");
         process.exit(0);
     };
     process.on("SIGINT", shutdown);
@@ -791,7 +739,7 @@ async function watch(targetPath = ".", options = {}) {
 async function runScript(script, cwd, verbose) {
     return new Promise((resolve) => {
         const [command, ...args] = script.split(" ");
-        const child = (0, child_process_1.spawn)(command, args, {
+        const child = spawn(command, args, {
             cwd,
             stdio: verbose ? "inherit" : "pipe", // Show output directly if verbose, otherwise capture
             shell: true,
@@ -813,7 +761,7 @@ async function runScript(script, cwd, verbose) {
             });
         });
         child.on("error", (error) => {
-            output_1.out.error(`Failed to run script: ${error.message}`);
+            out.error(`Failed to run script: ${error.message}`);
             resolve({
                 success: false,
                 output: !verbose ? output : undefined,
@@ -824,22 +772,22 @@ async function runScript(script, cwd, verbose) {
 /**
  * Set root directory URL for an existing or new pushwork directory
  */
-async function root(rootUrl, targetPath = ".", options = {}) {
+export async function root(rootUrl, targetPath = ".", options = {}) {
     if (!rootUrl.startsWith("automerge:")) {
-        output_1.out.error(`Invalid Automerge URL: ${rootUrl}\n` +
+        out.error(`Invalid Automerge URL: ${rootUrl}\n` +
             `Expected format: automerge:XXXXX`);
-        output_1.out.exit(1);
+        out.exit(1);
     }
     const resolvedPath = path.resolve(targetPath);
-    const syncToolDir = path.join(resolvedPath, config_1.ConfigManager.CONFIG_DIR);
-    if (await (0, utils_1.pathExists)(syncToolDir)) {
+    const syncToolDir = path.join(resolvedPath, ConfigManager.CONFIG_DIR);
+    if (await pathExists(syncToolDir)) {
         if (!options.force) {
-            output_1.out.error("Directory already initialized for pushwork. Use --force to overwrite");
-            output_1.out.exit(1);
+            out.error("Directory already initialized for pushwork. Use --force to overwrite");
+            out.exit(1);
         }
     }
-    await (0, utils_1.ensureDirectoryExists)(syncToolDir);
-    await (0, utils_1.ensureDirectoryExists)(path.join(syncToolDir, "automerge"));
+    await ensureDirectoryExists(syncToolDir);
+    await ensureDirectoryExists(path.join(syncToolDir, "automerge"));
     // Create minimal snapshot with just the root URL
     const snapshotPath = path.join(syncToolDir, "snapshot.json");
     const snapshot = {
@@ -851,9 +799,60 @@ async function root(rootUrl, targetPath = ".", options = {}) {
     };
     await fs.writeFile(snapshotPath, JSON.stringify(snapshot, null, 2), "utf-8");
     // Ensure config exists
-    const configManager = new config_1.ConfigManager(resolvedPath);
+    const configManager = new ConfigManager(resolvedPath);
     await configManager.initializeWithOverrides({});
-    output_1.out.successBlock("ROOT SET", rootUrl);
+    out.successBlock("ROOT SET", rootUrl);
+    process.exit();
+}
+/**
+ * Read a file document by its Automerge URL and print its content
+ */
+export async function read(docUrl, options = {}) {
+    if (!docUrl.startsWith("automerge:")) {
+        out.error(`Invalid Automerge URL: ${docUrl}\n` +
+            `Expected format: automerge:XXXXX`);
+        out.exit(1);
+    }
+    let repo;
+    if (options.remote) {
+        // Create an ephemeral repo with Subduction to fetch from sync server
+        repo = await createEphemeralRepo(DEFAULT_SYNC_SERVER);
+    }
+    else {
+        // Read from local pushwork storage
+        const ctx = await setupCommandContext(".", { syncEnabled: false });
+        repo = ctx.repo;
+    }
+    try {
+        const handle = await repo.find(docUrl);
+        const doc = await handle.doc();
+        if (!doc) {
+            out.error("Document not found or unavailable");
+            await safeRepoShutdown(repo);
+            out.exit(1);
+            return;
+        }
+        const content = readDocContent(doc.content);
+        if (content === null) {
+            out.error("Document has no content");
+            await safeRepoShutdown(repo);
+            out.exit(1);
+            return;
+        }
+        if (content instanceof Uint8Array) {
+            process.stdout.write(content);
+        }
+        else {
+            process.stdout.write(content);
+        }
+    }
+    catch (error) {
+        out.error(`Failed to read document: ${error}`);
+        await safeRepoShutdown(repo);
+        out.exit(1);
+        return;
+    }
+    await safeRepoShutdown(repo);
     process.exit();
 }
 function plural(word, count) {