island-bridge 2.0.0 → 2.0.1

package/dist/bin/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/bin/cli.js

@@ -0,0 +1,327 @@
+#!/usr/bin/env node
+import { parseArgs } from '../lib/args.js';
+import { loadConfig, extractFolderName } from '../lib/config.js';
+import { checkRsync, syncAll, diffPreview } from '../lib/sync.js';
+import { Reporter } from '../lib/reporter.js';
+import { startWatch } from '../lib/watch.js';
+import { recordSync, showHistory } from '../lib/history.js';
+import { runHook } from '../lib/hooks.js';
+import { selectPaths } from '../lib/interactive.js';
+import { runInit } from '../lib/init.js';
+import { runStatus } from '../lib/status.js';
+import { listBackups, restoreBackup, cleanBackups } from '../lib/backup.js';
+import { getErrorHint } from '../lib/summary.js';
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(join(__dirname, '..', '..', 'package.json'), 'utf-8'));
+const USAGE = `
+island-bridge v${pkg.version} - Sync remote folders via rsync over SSH
+
+Usage:
+  island-bridge <command> [options]
+
+Commands:
+  pull        Pull remote folders to local directory
+  push        Push local folders to remote server
+  watch       Watch local folders and auto-push on changes
+  diff        Preview changes without syncing
+  history     Show sync history
+  init        Create island-bridge.json config interactively
+  status      Show config, SSH, rsync, and paths status
+  backup      Manage sync backups (list, restore, clean)
+
+Options:
+  -n, --dry-run        Preview sync without making changes
+  -v, --verbose        Show detailed output
+  -q, --quiet          Suppress output (exit code only)
+  -c, --config <path>  Use specific config file
+      --env <name>     Use named profile from config
+      --bwlimit <KB/s> Limit transfer bandwidth
+  -s, --select         Interactively select folders to sync
+      --path <name>    Sync specific folder by name (repeatable)
+      --json           Output in JSON format (for scripts/AI)
+      --no-backup      Skip backup for this sync
+  -V, --version        Show version
+  -h, --help           Show this help message
+
+Backup subcommands:
+  backup list                  List available backups
+  backup restore <timestamp>   Restore files from a backup
+  backup clean --keep <N>      Remove old backups, keep N most recent
+`.trim();
+async function main() {
+    let args;
+    try {
+        args = parseArgs();
+    }
+    catch (err) {
+        console.error(`\x1b[31mError: ${err.message}\x1b[0m`);
+        process.exit(1);
+    }
+    const reporter = new Reporter(args.json ? 'json' : 'human');
+    if (args.help || (!args.command && !args.version)) {
+        console.log(USAGE);
+        process.exit(0);
+    }
+    if (args.version) {
+        if (args.json) {
+            reporter.setCommand('version');
+            reporter.info(pkg.version);
+            reporter.flush();
+        }
+        else {
+            console.log(`island-bridge v${pkg.version}`);
+        }
+        process.exit(0);
+    }
+    const validCommands = ['pull', 'push', 'watch', 'diff', 'history', 'init', 'status', 'backup'];
+    if (!validCommands.includes(args.command)) {
+        reporter.error(`Unknown command: ${args.command}`, `Valid commands: ${validCommands.join(', ')}`);
+        if (args.json)
+            reporter.flush();
+        process.exit(1);
+    }
+    reporter.setCommand(args.command);
+    // === Init ===
+    if (args.command === 'init') {
+        const ok = await runInit(args, reporter);
+        if (args.json)
+            reporter.flush();
+        process.exit(ok ? 0 : 1);
+    }
+    // === History (doesn't need rsync) ===
+    if (args.command === 'history') {
+        let config;
+        try {
+            config = loadConfig({ configPath: args.config ?? undefined, env: args.env ?? undefined });
+        }
+        catch {
+            // Show history from cwd if no config found
+        }
+        if (args.json) {
+            const { readFileSync: rfs, existsSync: efs } = await import('node:fs');
+            const { dirname: dn, join: jn } = await import('node:path');
+            const historyFile = config?._filePath
+                ? jn(dn(config._filePath), '.island-bridge-history.json')
+                : '.island-bridge-history.json';
+            let entries = [];
+            if (efs(historyFile)) {
+                try {
+                    const parsed = JSON.parse(rfs(historyFile, 'utf-8'));
+                    entries = Array.isArray(parsed) ? parsed : [];
+                }
+                catch { /* ignore */ }
+            }
+            reporter.historyReport(entries);
+            reporter.flush();
+        }
+        else {
+            showHistory(config?._filePath);
+        }
+        process.exit(0);
+    }
+    // === Backup ===
+    if (args.command === 'backup') {
+        let config;
+        try {
+            config = loadConfig({ configPath: args.config ?? undefined, env: args.env ?? undefined });
+        }
+        catch {
+            config = { backup: { enabled: true, localDir: '.island-bridge-backups', remoteDir: '~/.island-bridge-backups', maxCount: 10 } };
+        }
+        const backupConfig = config.backup;
+        if (args.subcommand === 'list') {
+            const backups = listBackups(backupConfig.localDir);
+            if (args.json) {
+                reporter.historyReport(backups.map((b) => ({ timestamp: b.name, date: b.date.toISOString() })));
+                reporter.flush();
+            }
+            else {
+                if (backups.length === 0) {
+                    console.log('No backups found.');
+                }
+                else {
+                    console.log('\n--- Backups ---\n');
+                    for (const b of backups) {
+                        console.log(`  ${b.name}  (${b.date.toLocaleString()})`);
+                    }
+                    console.log(`\n${backups.length} backup(s) found.`);
+                }
+            }
+            process.exit(0);
+        }
+        if (args.subcommand === 'restore') {
+            if (!args.backupTimestamp) {
+                reporter.error('backup restore requires a timestamp', 'Run "island-bridge backup list" to see available backups');
+                if (args.json)
+                    reporter.flush();
+                process.exit(1);
+            }
+            try {
+                const results = restoreBackup(backupConfig.localDir, args.backupTimestamp);
+                if (args.json) {
+                    for (const r of results) {
+                        reporter.syncEnd(r.folder, r);
+                    }
+                    reporter.flush();
+                }
+                else {
+                    for (const r of results) {
+                        if (r.success) {
+                            console.log(`  \x1b[32m\u2713\x1b[0m ${r.folder} restored`);
+                        }
+                        else {
+                            console.log(`  \x1b[31m\u2717\x1b[0m ${r.folder} \u2014 ${r.error}`);
+                        }
+                    }
+                }
+            }
+            catch (err) {
+                reporter.error(err.message, 'Run "island-bridge backup list" to see available backups');
+                if (args.json)
+                    reporter.flush();
+                process.exit(1);
+            }
+            process.exit(0);
+        }
+        if (args.subcommand === 'clean') {
+            const keep = args.keep || backupConfig.maxCount || 10;
+            const removed = cleanBackups(backupConfig.localDir, keep);
+            if (args.json) {
+                reporter.info(`Removed ${removed.length} backup(s), keeping ${keep}`);
+                reporter.flush();
+            }
+            else {
+                if (removed.length === 0) {
+                    console.log(`No backups to remove (keeping ${keep}).`);
+                }
+                else {
+                    for (const name of removed) {
+                        console.log(`  Removed: ${name}`);
+                    }
+                    console.log(`\nRemoved ${removed.length} backup(s), keeping ${keep}.`);
+                }
+            }
+            process.exit(0);
+        }
+        reporter.error('Unknown backup subcommand', 'Usage: island-bridge backup <list|restore|clean>');
+        if (args.json)
+            reporter.flush();
+        process.exit(1);
+    }
+    // === Pre-flight: check rsync ===
+    const rsyncOk = await checkRsync();
+    if (!rsyncOk) {
+        reporter.error('rsync is required but not found in PATH', getErrorHint('rsync-not-found'));
+        if (args.json)
+            reporter.flush();
+        process.exit(1);
+    }
+    // === Load config ===
+    let config;
+    try {
+        config = loadConfig({ configPath: args.config ?? undefined, env: args.env ?? undefined });
+    }
+    catch (err) {
+        const hint = err.message.includes('Cannot find')
+            ? getErrorHint('config-not-found')
+            : null;
+        reporter.error(err.message, hint);
+        if (args.json)
+            reporter.flush();
+        process.exit(1);
+    }
+    if (args.env) {
+        reporter.info(`Using profile: ${args.env}`);
+    }
+    if (config._filePath) {
+        reporter.info(`Config: ${config._filePath}`);
+    }
+    // === Status ===
+    if (args.command === 'status') {
+        await runStatus(config, reporter);
+        if (args.json)
+            reporter.flush();
+        process.exit(0);
+    }
+    // === --path filter ===
+    if (args.path.length > 0) {
+        const allNames = config.remote.paths.map((p) => extractFolderName(p));
+        const invalid = args.path.filter((name) => !allNames.includes(name));
+        if (invalid.length > 0) {
+            reporter.error(`Unknown folder name(s): ${invalid.join(', ')}`, `Available folders: ${allNames.join(', ')}`);
+            if (args.json)
+                reporter.flush();
+            process.exit(1);
+        }
+        config.remote.paths = config.remote.paths.filter((p) => args.path.includes(extractFolderName(p)));
+    }
+    // === Interactive selection ===
+    if (args.select && !args.json && ['pull', 'push', 'diff'].includes(args.command)) {
+        config.remote.paths = await selectPaths(config.remote.paths, reporter);
+    }
+    // === Watch mode ===
+    if (args.command === 'watch') {
+        startWatch(config, {
+            dryRun: args.dryRun,
+            verbose: args.verbose,
+            quiet: args.quiet,
+            bwlimit: args.bwlimit,
+            noBackup: args.noBackup,
+        }, reporter);
+        return;
+    }
+    // === Diff preview ===
+    if (args.command === 'diff') {
+        const diffs = await diffPreview(config, 'pull', {
+            bwlimit: args.bwlimit,
+            exclude: config.exclude,
+        });
+        reporter.diffReport(diffs);
+        if (args.json)
+            reporter.flush();
+        process.exit(0);
+    }
+    // === Pull or Push ===
+    const options = {
+        dryRun: args.dryRun,
+        verbose: args.verbose,
+        quiet: args.quiet,
+        bwlimit: args.bwlimit,
+        noBackup: args.noBackup,
+    };
+    // Disable hooks from configs found via upward search
+    if (!config._explicitConfig && config._filePath !== join(process.cwd(), 'island-bridge.json')) {
+        if (config.hooks.beforeSync || config.hooks.afterSync) {
+            reporter.warn(`hooks ignored from inherited config ${config._filePath}`);
+            reporter.warn(`Use --config ${config._filePath} to explicitly enable hooks.`);
+            config.hooks = {};
+        }
+    }
+    // Run beforeSync hook
+    if (config.hooks.beforeSync) {
+        runHook('beforeSync', config.hooks.beforeSync, args.quiet, reporter);
+    }
+    const results = await syncAll(config, args.command, options, reporter);
+    // Run afterSync hook
+    if (config.hooks.afterSync) {
+        runHook('afterSync', config.hooks.afterSync, args.quiet, reporter);
+    }
+    // Record history
+    recordSync(config._filePath, args.command, results);
+    // Print summary
+    if (!args.quiet || args.json) {
+        reporter.summary(results);
+        if (!args.json && args.dryRun) {
+            reporter.info('(dry-run mode \u2014 no changes were made)');
+        }
+    }
+    if (args.json)
+        reporter.flush();
+    const hasFailed = results.some((r) => !r.success);
+    process.exit(hasFailed ? 1 : 0);
+}
+main();
+//# sourceMappingURL=cli.js.map

package/dist/bin/cli.js.map

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

package/dist/lib/args.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Lightweight CLI argument parser for island-bridge.
+ * Zero dependencies.
+ */
+import type { ParsedArgs } from './types.js';
+export declare function parseArgs(argv?: string[]): ParsedArgs;

package/dist/lib/args.js

@@ -0,0 +1,128 @@
+export function parseArgs(argv = process.argv.slice(2)) {
+    const args = {
+        command: null,
+        subcommand: null,
+        dryRun: false,
+        verbose: false,
+        quiet: false,
+        json: false,
+        config: null,
+        env: null,
+        bwlimit: null,
+        select: false,
+        noBackup: false,
+        path: [],
+        help: false,
+        version: false,
+        // init-specific
+        host: null,
+        user: null,
+        paths: null,
+        // backup-specific
+        backupTimestamp: null,
+        keep: null,
+    };
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        switch (arg) {
+            case '--dry-run':
+            case '-n':
+                args.dryRun = true;
+                break;
+            case '--verbose':
+            case '-v':
+                args.verbose = true;
+                break;
+            case '--quiet':
+            case '-q':
+                args.quiet = true;
+                break;
+            case '--json':
+                args.json = true;
+                break;
+            case '--config':
+            case '-c':
+                args.config = argv[++i];
+                if (!args.config || args.config.startsWith('-'))
+                    throw new Error('--config requires a file path');
+                break;
+            case '--env':
+                args.env = argv[++i];
+                if (!args.env || args.env.startsWith('-'))
+                    throw new Error('--env requires a profile name');
+                break;
+            case '--bwlimit': {
+                const bwRaw = argv[++i];
+                if (!bwRaw || isNaN(Number(bwRaw))) {
+                    throw new Error('--bwlimit requires a numeric value (KB/s)');
+                }
+                args.bwlimit = Number(bwRaw);
+                break;
+            }
+            case '--select':
+            case '-s':
+                args.select = true;
+                break;
+            case '--no-backup':
+                args.noBackup = true;
+                break;
+            case '--path':
+                {
+                    const val = argv[++i];
+                    if (!val || val.startsWith('-'))
+                        throw new Error('--path requires a folder name');
+                    args.path.push(val);
+                }
+                break;
+            case '--host':
+                args.host = argv[++i];
+                if (!args.host)
+                    throw new Error('--host requires a value');
+                break;
+            case '--user':
+                args.user = argv[++i];
+                if (!args.user)
+                    throw new Error('--user requires a value');
+                break;
+            case '--paths':
+                args.paths = argv[++i];
+                if (!args.paths)
+                    throw new Error('--paths requires a value');
+                break;
+            case '--keep': {
+                const keepRaw = argv[++i];
+                if (!keepRaw || isNaN(Number(keepRaw))) {
+                    throw new Error('--keep requires a numeric value');
+                }
+                args.keep = Number(keepRaw);
+                break;
+            }
+            case '--help':
+            case '-h':
+                args.help = true;
+                break;
+            case '--version':
+            case '-V':
+                args.version = true;
+                break;
+            default:
+                if (!arg.startsWith('-')) {
+                    if (!args.command) {
+                        args.command = arg;
+                    }
+                    else if (args.command === 'backup' && !args.subcommand) {
+                        args.subcommand = arg;
+                    }
+                    else if (args.command === 'backup' && args.subcommand === 'restore' && !args.backupTimestamp) {
+                        args.backupTimestamp = arg;
+                    }
+                }
+                break;
+        }
+    }
+    if (args.verbose && args.quiet) {
+        throw new Error('Cannot use --verbose and --quiet together');
+    }
+    return args;
+}
+//# sourceMappingURL=args.js.map

package/dist/lib/args.js.map

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

package/dist/lib/backup.d.ts

@@ -0,0 +1,26 @@
+import type { BackupEntry, RestoreResult } from './types.js';
+/**
+ * Generate a backup directory path.
+ */
+export declare function generateBackupDir(baseDir: string, folderName: string, date?: Date): string;
+/**
+ * Build rsync backup args.
+ */
+export declare function buildBackupArgs(direction: string, localDir: string | null, remoteDir: string | null, folderName: string, date?: Date): string[];
+/**
+ * Parse a list of directory names and return valid timestamped ones, sorted ascending.
+ */
+export declare function parseBackupDirs(dirs: string[]): BackupEntry[];
+/**
+ * List local backups.
+ */
+export declare function listBackups(baseDir: string): BackupEntry[];
+/**
+ * Restore a backup by copying files back.
+ */
+export declare function restoreBackup(baseDir: string, timestamp: string, targetDir?: string): RestoreResult[];
+/**
+ * Clean old backups, keeping the N most recent.
+ * @returns removed directory names
+ */
+export declare function cleanBackups(baseDir: string, keep: number): string[];

package/dist/lib/backup.js

@@ -0,0 +1,96 @@
+import { existsSync, readdirSync, rmSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+import { execFileSync } from 'node:child_process';
+const TIMESTAMP_RE = /^\d{4}-\d{2}-\d{2}T\d{2}-\d{2}-\d{2}$/;
+/**
+ * Format a Date as a filesystem-safe timestamp.
+ */
+function formatTimestamp(date) {
+    return date.toISOString().replace(/:/g, '-').replace(/\.\d{3}Z$/, '');
+}
+/**
+ * Generate a backup directory path.
+ */
+export function generateBackupDir(baseDir, folderName, date = new Date()) {
+    const ts = formatTimestamp(date);
+    return `${baseDir}/${ts}/${folderName}`;
+}
+/**
+ * Build rsync backup args.
+ */
+export function buildBackupArgs(direction, localDir, remoteDir, folderName, date = new Date()) {
+    if (direction === 'pull' && localDir) {
+        const backupDir = generateBackupDir(localDir, folderName, date);
+        return ['--backup', `--backup-dir=${backupDir}`];
+    }
+    if (direction === 'push' && remoteDir) {
+        const backupDir = generateBackupDir(remoteDir, folderName, date);
+        return ['--backup', `--backup-dir=${backupDir}`];
+    }
+    return [];
+}
+/**
+ * Parse a list of directory names and return valid timestamped ones, sorted ascending.
+ */
+export function parseBackupDirs(dirs) {
+    return dirs
+        .filter(d => TIMESTAMP_RE.test(d))
+        .map(d => ({
+        name: d,
+        date: new Date(d.replace(/T(\d{2})-(\d{2})-(\d{2})$/, 'T$1:$2:$3Z')),
+    }))
+        .sort((a, b) => a.date.getTime() - b.date.getTime());
+}
+/**
+ * List local backups.
+ */
+export function listBackups(baseDir) {
+    if (!existsSync(baseDir))
+        return [];
+    const dirs = readdirSync(baseDir).filter(d => {
+        const full = join(baseDir, d);
+        return statSync(full).isDirectory();
+    });
+    return parseBackupDirs(dirs);
+}
+/**
+ * Restore a backup by copying files back.
+ */
+export function restoreBackup(baseDir, timestamp, targetDir = '.') {
+    const backupPath = join(baseDir, timestamp);
+    if (!existsSync(backupPath)) {
+        throw new Error(`Backup not found: ${timestamp}`);
+    }
+    const folders = readdirSync(backupPath).filter(d => statSync(join(backupPath, d)).isDirectory());
+    const results = [];
+    for (const folder of folders) {
+        const src = join(backupPath, folder) + '/';
+        const dst = join(targetDir, folder) + '/';
+        try {
+            execFileSync('rsync', ['-av', '--', src, dst], { stdio: 'pipe' });
+            results.push({ folder, success: true, error: null });
+        }
+        catch (err) {
+            results.push({ folder, success: false, error: err.message });
+        }
+    }
+    return results;
+}
+/**
+ * Clean old backups, keeping the N most recent.
+ * @returns removed directory names
+ */
+export function cleanBackups(baseDir, keep) {
+    const backups = listBackups(baseDir);
+    if (backups.length <= keep)
+        return [];
+    const toRemove = backups.slice(0, backups.length - keep);
+    const removed = [];
+    for (const b of toRemove) {
+        const fullPath = join(baseDir, b.name);
+        rmSync(fullPath, { recursive: true, force: true });
+        removed.push(b.name);
+    }
+    return removed;
+}
+//# sourceMappingURL=backup.js.map

package/dist/lib/backup.js.map

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

package/dist/lib/config.d.ts

@@ -0,0 +1,25 @@
+import type { IslandBridgeConfig, BackupConfig } from './types.js';
+/**
+ * Search for config file starting from startDir, walking up to root.
+ */
+export declare function findConfigFile(startDir?: string): string | null;
+/**
+ * Load and validate config.
+ */
+export declare function loadConfig(options?: {
+    configPath?: string;
+    env?: string;
+}): IslandBridgeConfig;
+/**
+ * Return default backup config values.
+ */
+export declare function backupDefaults(): BackupConfig;
+/**
+ * Validate backup config section.
+ */
+export declare function validateBackupConfig(backup: any): void;
+/**
+ * Extract folder name (last path component) from a remote path.
+ * Strips trailing slashes. Rejects root "/" and empty strings.
+ */
+export declare function extractFolderName(remotePath: string): string;