pushwork 2.0.0-a.sub.1 → 2.0.0-preview.2

package/README.md

@@ -1,221 +0,0 @@
-# Pushwork
-
-Bidirectional file synchronization using Automerge CRDTs for conflict-free collaborative editing.
-
-## Features
-
-- **Conflict-Free Sync**: Automatic conflict resolution using Automerge CRDTs
-- **Real-time Collaboration**: Multiple users can edit the same files simultaneously
-- **Intelligent Move Detection**: Detects file renames and moves based on content similarity
-- **Offline Support**: Works offline and gracefully handles network interruptions
-- **Cross-Platform**: Runs on Windows, macOS, and Linux
-
-## Installation
-
-```bash
-pnpm install
-pnpm run build
-pnpm link --global
-```
-
-Requires: Node.js 18+, pnpm 8.15.0+
-
-## Quick Start
-
-```bash
-# Initialize a directory
-pushwork init ./my-project
-
-# Clone an existing repository
-pushwork clone <automerge-url> ./project
-
-# Sync changes
-pushwork sync
-
-# Check status
-pushwork status
-
-# Get shareable URL
-pushwork url
-```
-
-## Commands
-
-### Core Commands
-
-**`init [path]`** - Initialize sync in a directory
-
-- `--sync-server <url>` - Custom sync server URL
-- `--sync-server-storage-id <id>` - Custom storage ID
-- `--debug` - Export performance flame graphs
-
-**`clone <url> <path>`** - Clone an existing synced directory
-
-- `--force` - Overwrite existing directory
-- `--sync-server <url>` - Custom sync server URL
-- `--sync-server-storage-id <id>` - Custom storage ID
-
-**`sync [path]`** - Run bidirectional synchronization
-
-- `--dry-run` - Preview changes without applying
-- `--verbose` - Show detailed progress
-- `--debug` - Export performance flame graphs
-
-**`status [path]`** - Show sync status and repository info
-
-- `--verbose` - Show detailed status including all tracked files
-
-**`commit [path]`** - Commit local changes without network sync
-
-- `--dry-run` - Preview what would be committed
-- `--debug` - Export performance flame graphs
-
-### Utility Commands
-
-**`diff [path]`** - Show differences between local and remote
-
-- `--name-only` - Show only changed file names
-
-**`url [path]`** - Show the Automerge root URL for sharing
-
-**`ls [path]`** - List tracked files
-
-- `--long` - Show Automerge URLs
-
-**`config [path]`** - View or edit configuration
-
-- `--list` - Show full configuration
-- `--get <key>` - Get specific config value (dot notation)
-
-**`rm [path]`** - Remove local pushwork data
-
-**`watch [path]`** - Watch directory, build, and sync automatically
-
-- `--script <command>` - Build script (default: "pnpm build")
-- `--dir <dir>` - Directory to watch (default: "src")
-- `--verbose` - Show build output
-
-**`log [path]`** - Show sync history _(experimental, limited functionality)_
-
-**`checkout <sync-id> [path]`** - Restore to previous sync _(not yet implemented)_
-
-## Configuration
-
-Configuration is stored in `.pushwork/config.json`:
-
-```json
-{
-  "sync_server": "wss://sync3.automerge.org",
-  "sync_server_storage_id": "3760df37-a4c6-4f66-9ecd-732039a9385d",
-  "sync_enabled": true,
-  "defaults": {
-    "exclude_patterns": [".git", "node_modules", "*.tmp", ".pushwork"],
-    "large_file_threshold": "100MB"
-  },
-  "diff": {
-    "show_binary": false
-  },
-  "sync": {
-    "move_detection_threshold": 0.8,
-    "prompt_threshold": 0.5,
-    "auto_sync": false,
-    "parallel_operations": 4
-  }
-}
-```
-
-## How It Works
-
-Pushwork uses Automerge CRDTs for automatic conflict resolution:
-
-- **Text files**: Character-level merging preserves all changes
-- **Binary files**: Last-writer-wins with automatic convergence
-- **Directories**: Additive merging supports simultaneous file creation
-
-Sync process:
-
-1. **Push**: Apply local changes to Automerge documents
-2. **Pull**: Apply remote changes to local filesystem
-3. **Convergence**: All repositories reach identical state
-
-State tracking:
-
-- `.pushwork/snapshot.json` - Tracks sync state and file mappings
-- `.pushwork/config.json` - Configuration settings
-- Content-based change detection using Automerge document heads
-
-### Document Schema
-
-**File Document:**
-
-```typescript
-{
-  "@patchwork": { type: "file" };
-  name: string;
-  extension: string;
-  mimeType: string;
-  content: string | Uint8Array;
-  metadata: {
-    permissions: number;
-  };
-}
-```
-
-**Directory Document:**
-
-```typescript
-{
-  "@patchwork": { type: "folder" };
-  docs: Array<{
-    name: string;
-    type: "file" | "folder";
-    url: AutomergeUrl;
-  }>;
-  lastSyncAt?: number;
-}
-```
-
-## Development
-
-### Setup
-
-```bash
-git clone <repository-url>
-cd pushwork
-pnpm install
-pnpm run build
-pnpm run dev          # Watch mode
-pnpm test             # Run tests
-pnpm run test:watch   # Watch mode for tests
-```
-
-### Project Structure
-
-```
-src/
-├── cli/        # Command-line interface
-├── core/       # Core sync engine
-├── config/     # Configuration management
-├── tracing/    # Performance tracing
-├── types/      # TypeScript type definitions
-└── utils/      # Shared utilities
-```
-
-### Testing
-
-```bash
-pnpm test                                              # Unit tests
-./test/run-tests.sh                                    # All integration tests
-./test/integration/conflict-resolution-test.sh         # Specific test
-```
-
-### Profiling
-
-```bash
-pushwork sync --debug                                  # Export flame graphs
-clinic flame --collect-only -- node --enable-source-maps --prof $(pnpm root -g)/pushwork/dist/cli.js sync
-```
-
-## License
-
-MIT License

package/babel.config.js

@@ -1,5 +0,0 @@
-module.exports = {
-  presets: [
-    ['@babel/preset-env', { targets: { node: 'current' } }]
-  ]
-};

package/dist/cli/commands.d.ts

@@ -1,71 +0,0 @@
-import { Repo } from "@automerge/automerge-repo";
-import { CloneOptions, SyncOptions, DiffOptions, LogOptions, CheckoutOptions, DirectoryConfig } from "../types";
-import { SyncEngine } from "../core";
-/**
- * Shared context that commands can use
- */
-export interface CommandContext {
-    repo: Repo;
-    syncEngine: SyncEngine;
-    config: DirectoryConfig;
-    workingDir: string;
-}
-/**
- * Shared pre-action that ensures repository and sync engine are properly initialized
- * This function always works, with or without network connectivity
- */
-export declare function setupCommandContext(workingDir?: string, customSyncServer?: string, customStorageId?: string, enableNetwork?: boolean): Promise<CommandContext>;
-/**
- * Safely shutdown a repository with proper error handling
- */
-export declare function safeRepoShutdown(repo: Repo, context?: string): Promise<void>;
-/**
- * Common progress message helpers
- */
-export declare const ProgressMessages: {
-    directoryFound: () => void;
-    configLoaded: () => void;
-    repoConnected: () => void;
-    syncServer: (server: string) => void;
-    storageId: (id: string) => void;
-    rootUrl: (url: string) => void;
-    changesWritten: () => void;
-    syncCompleted: (duration: number) => void;
-    directoryStructureCreated: () => void;
-    configSaved: () => void;
-    repoCreated: () => void;
-};
-/**
- * Initialize sync in a directory
- */
-export declare function init(targetPath: string, syncServer?: string, syncServerStorageId?: string): Promise<void>;
-/**
- * Run bidirectional sync
- */
-export declare function sync(options: SyncOptions): Promise<void>;
-/**
- * Show differences between local and remote
- */
-export declare function diff(targetPath: string | undefined, options: DiffOptions): Promise<void>;
-/**
- * Show sync status
- */
-export declare function status(): Promise<void>;
-/**
- * Show sync history
- */
-export declare function log(targetPath: string | undefined, options: LogOptions): Promise<void>;
-/**
- * Checkout/restore from previous sync
- */
-export declare function checkout(syncId: string, targetPath: string | undefined, options: CheckoutOptions): Promise<void>;
-/**
- * Clone an existing synced directory from an AutomergeUrl
- */
-export declare function clone(rootUrl: string, targetPath: string, options: CloneOptions): Promise<void>;
-/**
- * Get the root URL for the current pushwork repository
- */
-export declare function url(targetPath?: string): Promise<void>;
-export declare function commit(targetPath: string, dryRun?: boolean): Promise<void>;
-//# sourceMappingURL=commands.d.ts.map

package/dist/cli/commands.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/cli/commands.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAA2B,MAAM,2BAA2B,CAAC;AAI1E,OAAO,EAEL,YAAY,EACZ,WAAW,EACX,WAAW,EACX,UAAU,EACV,eAAe,EACf,eAAe,EAEhB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAMrC;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,IAAI,CAAC;IACX,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,EAAE,eAAe,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,GAAE,MAAsB,EAClC,gBAAgB,CAAC,EAAE,MAAM,EACzB,eAAe,CAAC,EAAE,MAAM,EACxB,aAAa,GAAE,OAAc,GAC5B,OAAO,CAAC,cAAc,CAAC,CAqCzB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,IAAI,EACV,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAqBf;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;yBAON,MAAM;oBAEX,MAAM;mBACP,MAAM;;8BAKK,MAAM;;;;CAOjC,CAAC;AA+DF;;GAEG;AACH,wBAAsB,IAAI,CACxB,UAAU,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,MAAM,EACnB,mBAAmB,CAAC,EAAE,MAAM,GAC3B,OAAO,CAAC,IAAI,CAAC,CA6Hf;AAED;;GAEG;AACH,wBAAsB,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAgM9D;AAED;;GAEG;AACH,wBAAsB,IAAI,CACxB,UAAU,oBAAM,EAChB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CA6Df;AAED;;GAEG;AACH,wBAAsB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CA6H5C;AAED;;GAEG;AACH,wBAAsB,GAAG,CACvB,UAAU,oBAAM,EAChB,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,IAAI,CAAC,CA2Cf;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,MAAM,EACd,UAAU,oBAAM,EAChB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,IAAI,CAAC,CAkBf;AAED;;GAEG;AACH,wBAAsB,KAAK,CACzB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,IAAI,CAAC,CA6Hf;AAED;;GAEG;AACH,wBAAsB,GAAG,CAAC,UAAU,SAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAuCzD;AAED,wBAAsB,MAAM,CAC1B,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,OAAe,GACtB,OAAO,CAAC,IAAI,CAAC,CAgEf"}