@frakjs/frak 0.1.0 → 0.2.0

package/README.md

@@ -1,138 +1,210 @@
-# Frak
+<a id="readme-top"></a>
+
+<!-- PROJECT SHIELDS -->
+[![Contributors][contributors-shield]][contributors-url]
+[![Forks][forks-shield]][forks-url]
+[![Stargazers][stars-shield]][stars-url]
+[![Issues][issues-shield]][issues-url]
+[![MIT][license-shield]][license-url]
+
+<!-- PROJECT LOGO -->
+<br />
+<div align="center">
+  <a href="https://github.com/frakjs/frak">
+    <img src="images/logos/Frak Logo - Green - 256.png" width="112" />
+  </a>
+
+  <h3 align="center">frak</h3>
+
+  <p align="center">
+    Deploy from point A → point B, without the drama.
+    <br />
+    <br />
+    <a href="https://github.com/frakjs/frak/issues/new?labels=bug&template=bug-report---.md">Report Bug</a>
+    &middot;
+    <a href="https://github.com/frakjs/frak/issues/new?labels=enhancement&template=feature-request---.md">Request Feature</a>
+  </p>
+</div>
+
+<!-- TABLE OF CONTENTS -->
+<details>
+  <summary>Table of Contents</summary>
+  <ol>
+    <li>
+      <a href="#about-the-project">About The Project</a>
+    </li>
+    <li>
+      <a href="#getting-started">Getting Started</a>
+      <ul>
+        <li><a href="#prerequisites">Prerequisites</a></li>
+      </ul>
+    </li>
+    <li><a href="#usage">Usage</a></li>
+    <li><a href="#roadmap">Roadmap</a></li>
+    <li><a href="#contributing">Contributing</a></li>
+    <li><a href="#license">License</a></li>
+    <li><a href="#contact">Contact</a></li>
+  </ol>
+</details>
+
+
+
+<!-- ABOUT THE PROJECT -->
+## About The Project
+
+[![Product Name Screen Shot][product-screenshot]](https://frakjs.com)
+
+**`frak`** is a tiny JavaScript binary for deployments that don’t need containers or repos—just fast, reliable file transfer from point A to point B.
+
+It leverages `rsync` over SSH to push files to a remote server, and is able to visualize file changes in a developer-friendly way. **`frak`** has a number of advanced features beyond syncing files to a remote server, such as keeping a history of deployments for easy rollback, showing file differences prior to pushing, and executing post-deploy hooks.
+
+### 🚀 Features
+
+🔌 **Init once, deploy anytime**<br>
+🔎 **Interactive diffs** before every push/pull<br>
+📦 **Patch-based backups** stored on your server<br>
+🧾 **Post-deploy commands** (e.g. restart services)<br>
+📡 **Quick SSH console access** into deploy root<br>
+🔁 **Pull support** for syncing back changes<br>
+📋 **Backup inspection** with additions/deletions summary
+
+<p align="right">(<a href="#readme-top">back to top</a>)</p>
+
+<!-- GETTING STARTED -->
+## Getting Started
+
+Using **`frak`** is simple. All you need is a [Node.js](https://nodejs.org) environment with `npx`.
+
+### Prerequisites
+
+Make sure you have Node.js and `npx` installed.
 
-**Frak** is an agentless deployment tool for web apps. Powered by `rsync` over SSH, it tracks file changes, creates patch backups, and supports dry-run diffs, interactive confirmations, and post-deploy hooks.
-
-> “Frak it, ship it.”
+```bash
+node --version
+npm --version
+npx --version
+```
 
-&nbsp;
+[![Node.js and NPM Screenshot][prerequisites-screenshot]]()
 
-## 🚀 Features
+<p align="right">(<a href="#readme-top">back to top</a>)</p>
 
-- 🔌 **Init once, deploy anytime**
-- 🔎 **Interactive diffs** before every push/pull
-- 📦 **Patch-based backups** stored on your server
-- 🧾 **Post-deploy commands** (e.g. restart services)
-- 📡 **SSH console access** into deploy root
-- 🔁 **Pull support** for syncing back changes
-- 📋 **Backup inspection** with additions/deletions summary
+<!-- USAGE EXAMPLES -->
+## Usage
 
-## 📦 Installation
+The recommended way to run **`frak`** is via the `npx` command.
 
 ```bash
-npm install -g @frakjs/frak
+npx @frakjs/frak --help
 ```
 
-Or run it on-demand with `npx`
+If you're prompted to install the package, say _yes_.
 
-```bash
-npx @frakjs/frak <command>
+```
+Need to install the following packages:
+@frakjs/frak@0.1.0
+Ok to proceed? (y)
 ```
 
-## 🛠️ Setup
+**`frak`** needs to be initialized in your project directory with the `init` command.
 
 ```bash
-frak init
+cd project-folder
+npx @frakjs/frak init
 ```
 
-This creates a `frak.config.js` file:
+[![frak init][frak-init-screenshot]]()
+
+This creates a `frak.config.js` file that looks something like this:
 
 ```js
 export default {
     server: "user@example.com",
     root: "/var/www/html",
-    after: "npm run restart" // optional post-deploy hook
 };
 ```
 
-## 🧩 Commands
+You can replace `server` and `root` with the appropriate values for your environment.
 
-```
-frak init              # Create config file
-frak console           # SSH into the deploy root
-frak diff              # Show dry-run changes
-frak push              # Deploy changes (with confirmation)
-frak pull              # Download changes from remote
-frak backups:list      # List previous patch deployments
-```
+With the configuration in place, you can now start <b>`frak`</b>ing files to your server. It's as simple as the basic command without any arguments.
 
-## 🔐 Authentication
+```bash
+npx @frakjs/frak
+```
 
-Frak uses SSH. Make sure your public key is in `~/.ssh/authorized_keys` on the remote server.
+The results of the command will show you a dry-run preview of the changes that will be synced to the remote server. You will be prompted before it proceeds with the actual file transfer.
 
-## 🧪 Example: Deployment Flow
+If you'd like, you can cancel the sync by typing "no" or any non-"yes" value. Perhaps you want to see the changes line-by-line. **`frak`** can do this too!
 
 ```bash
-frak diff          # See what will change
-frak push          # Sync files, confirm, deploy
+npx @frakjs/frak diff
 ```
 
-Behind the scenes:
+The command above will compare all the changes, and present a colorful git-style patch that you can inspect in your terminal.
 
-- Files are compared with a dry-run rsync
-- If approved, a patch file is generated and saved
-- Files are synced live
-- Optional after script is run remotely
+<p align="right">(<a href="#readme-top">back to top</a>)</p>
 
-## 💾 Backups
+<!-- ROADMAP -->
+## Roadmap
 
-Each deployment saves a `.patch` file on the server under `.backups/`. You can list them with:
+- [ ] Send an alert via Slack after push events
+- [ ] Parallel deployments to multiple environments at once
 
-```bash
-frak backups:list
-```
+See the [open issues](https://github.com/frakjs/frak/issues) for a full list of proposed features (and known issues).
 
-Output shows:
+<p align="right">(<a href="#readme-top">back to top</a>)</p>
 
-- Timestamp
-- Filename
-- Additions and deletions in the patch
+<!-- CONTRIBUTING -->
+## Contributing
 
-## 🧠 Design Philosophy
+Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.
 
-- Minimal dependencies
-- Pure CLI
-- Patch-based history
-- No Docker or Node on server
-- Human-friendly
+If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".
+Don't forget to give the project a star! Thanks again!
 
-## 🧰 Advanced Config (optional)
+1. Fork the Project
+2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
+3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
+4. Push to the Branch (`git push origin feature/AmazingFeature`)
+5. Open a Pull Request
 
-```js
-export default {
-    server: 'user@host',
-    root: '/srv/www',
-    after: 'sudo systemctl reload nginx',
+<p align="right">(<a href="#readme-top">back to top</a>)</p>
 
-    dev: {
-        root: '/srv/www-dev',
-    },
-
-    production: {
-        root: '/srv/www-prod',
-    },
-};
-```
+### Top contributors:
 
-```bash
-frak push                   # uses default root-level properties
-frak push env=dev           # uses properties in "dev" to override
-frak push env=production    # uses properties in "production" to override
-```
+<a href="https://github.com/frakjs/frak/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=frakjs/frak" alt="contrib.rocks image" />
+</a>
 
-## 🐛 Debugging
+<!-- LICENSE -->
+## License
 
-Enable debug output by setting `DEBUG=1`:
+Distributed under the MIT License. See `LICENSE.txt` for more information.
 
-```bash
-DEBUG=1 frak push
-```
+<p align="right">(<a href="#readme-top">back to top</a>)</p>
 
-## 📄 License
+<!-- CONTACT -->
+## Contact
 
-MIT
+Frank Strube - [@strube](https://x.com/strube) - contact@frakjs.com
 
-## 🧑‍💻 Author
+Project Link: [https://github.com/frakjs/frak](https://github.com/frakjs/frak)
 
-Built by [Frank Strube](https://github.com/fstrube)
+<p align="right">(<a href="#readme-top">back to top</a>)</p>
 
-Contributions and suggestions welcome!
+<!-- MARKDOWN LINKS & IMAGES -->
+<!-- https://www.markdownguide.org/basic-syntax/#reference-style-links -->
+[contributors-shield]: https://img.shields.io/github/contributors/frakjs/frak.svg?style=for-the-badge
+[contributors-url]: https://github.com/frakjs/frak/graphs/contributors
+[forks-shield]: https://img.shields.io/github/forks/frakjs/frak.svg?style=for-the-badge
+[forks-url]: https://github.com/frakjs/frak/network/members
+[stars-shield]: https://img.shields.io/github/stars/frakjs/frak.svg?style=for-the-badge
+[stars-url]: https://github.com/frakjs/frak/stargazers
+[issues-shield]: https://img.shields.io/github/issues/frakjs/frak.svg?style=for-the-badge
+[issues-url]: https://github.com/frakjs/frak/issues
+[license-shield]: https://img.shields.io/github/license/frakjs/frak.svg?style=for-the-badge
+[license-url]: https://github.com/frakjs/frak/blob/master/LICENSE.txt
+[green-logo]: images/logos/Frak%20Logo%20-%20Green%20-%20256.png
+[product-screenshot]: images/screenshots/screenshot.png
+[prerequisites-screenshot]: images/screenshots/node-npm-version.png
+[frak-init-screenshot]: images/screenshots/frak-init-screenshot.png

package/bin/frak.js

@@ -1,8 +1,7 @@
 #!/usr/bin/env node
 
 import { execSync, spawn } from 'node:child_process';
-import { readFileSync, writeFileSync, existsSync, statSync } from 'node:fs';
-import { fileURLToPath } from 'node:url';
+import { writeFileSync, existsSync } from 'node:fs';
 import path from 'node:path';
 import * as ansi from '../src/ansi.js';
 import * as cli from '../src/cli.js';
@@ -15,8 +14,6 @@ import * as rsync from '../src/rsync.js';
 import * as ssh from '../src/ssh.js';
 import * as date from '../src/date.js';
 
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-
 /**
  * Try to load config. If it fails, print error message in red.
  *
@@ -26,7 +23,7 @@ async function tryLoadConfig(env) {
     try {
         await loadConfig(env);
     } catch (e) {
-        console.log(ansi.red(e.message));
+        console.error(ansi.red(e.message));
 
         process.exit(1);
     }
@@ -58,7 +55,6 @@ async function main(args) {
 
     debug('parsed:', { command, options });
 
-
     // Initialize Frak in the current directory
     if (command === 'init') {
         const configPath = path.join(process.cwd(), 'frak.config.js');
@@ -91,9 +87,17 @@ async function main(args) {
     } else if (command === 'diff') {
         await tryLoadConfig(options.env);
 
-        const { output } = await rsync.exec('--dry-run');
+        try {
+            const { output } = await rsync.exec('--dry-run');
 
-        await diff(output, options);
+            debug({ output });
+
+            await diff(output, options);
+        } catch (e) {
+            debug(e);
+
+            console.error(e.message);
+        }
 
     // Push or pull changes to remote server
     } else if (command === 'push' || command === 'pull') {
@@ -102,10 +106,13 @@ async function main(args) {
         // Execute dry-run
         const { output } = await rsync.exec('--dry-run');
 
+        debug({ output });
+
         console.log(humanize(output));
 
         if (command === 'push' && config.after) {
-            console.log(ansi.blue('Run command:'), config.after, '\n');
+            console.log(ansi.blue('Run command:'), config.after);
+            console.log('');
         }
 
         const proceed = await cli.agree(ansi.yellow('The above actions will be taken. Continue? (This cannot be undone): '));
@@ -115,14 +122,18 @@ async function main(args) {
         }
 
         // Prepare patch file
-        let patch;
+        let patch = '';
 
-        try {
-            patch = await diff(output, { interactive: false });
-        } catch (e) {
-            console.error(e);
+        if (command === 'push') {
+            try {
+                patch = await diff(output, { interactive: false });
+            /* node:coverage disable */
+            } catch (e) {
+                console.error(e);
 
-            process.exit(1);
+                process.exit(1);
+            }
+            /* node:coverage enable */
         }
 
         // Execute actual rsync command
@@ -132,12 +143,14 @@ async function main(args) {
         console.log(humanize(actualOutput));
 
         // Place patch file in backup dir
-        const hash = sha256(patch).slice(0, 7);
-        const copy = spawn('ssh', [config.server, '--', `cat > '${config.root || '.'}/${backupPath}/${hash}.patch'`]);
+        if (command === 'push') {
+            const hash = sha256(patch).slice(0, 7);
+            const copy = spawn('ssh', [config.server, '--', `cat > '${config.root || '.'}/${backupPath}/${hash}.patch'`]);
 
-        copy.stdout.on('data', (data) => debug('' + data));
-        copy.stderr.on('data', (data) => debug('' + data));
-        copy.stdin.write(patch);
+            copy.stdout.on('data', (data) => debug('' + data));
+            copy.stderr.on('data', (data) => debug('' + data));
+            copy.stdin.write(patch);
+        }
 
         // Execute "after" command
         if (command === 'push' && config.after) {
@@ -147,9 +160,11 @@ async function main(args) {
 
             try {
                 await ssh.exec(config.after, { server: config.server, root: config.root });
+            /* node:coverage disable */
             } catch (e) {
                 debug(e);
             }
+            /* node:coverage enable */
         }
 
         // TODO Webhook

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frakjs/frak",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "A commandline deployment tool for syncing files to remote servers.",
   "main": "index.js",
   "bin": {
@@ -8,7 +8,8 @@
   },
   "type": "module",
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "eslint": "eslint",
+    "test": "node --test --experimental-test-coverage"
   },
   "repository": {
     "type": "git",
@@ -24,5 +25,13 @@
   "bugs": {
     "url": "https://github.com/frakjs/frak/issues"
   },
-  "homepage": "https://github.com/frakjs/frak#readme"
+  "homepage": "https://github.com/frakjs/frak#readme",
+  "devDependencies": {
+    "@eslint/js": "^9.33.0",
+    "eslint": "^9.33.0",
+    "globals": "^16.3.0"
+  },
+  "dependencies": {
+    "yaml": "^2.8.1"
+  }
 }

package/src/ansi.js

@@ -15,7 +15,7 @@ const ansi = {
 };
 
 export function strip(string) {
-    return string
+    return `${string}`
         .replace(new RegExp(ansi.CLEAR.replace('[', '\\['), 'g'), '')
         .replace(new RegExp(ansi.BOLD.replace('[', '\\['), 'g'), '')
         .replace(new RegExp(ansi.UNDERLINE.replace('[', '\\['), 'g'), '')

package/src/cli.js

@@ -13,7 +13,11 @@ export function parse(args) {
     };
 
     for (let arg of args) {
-        if (arg.includes('=')) {
+        if (arg === '--yes' || arg === '-y') {
+            options.interactive = false;
+        } else if (arg === '--no-color') {
+            options.colorize = false;
+        } else if (arg.includes('=')) {
             const [option, value] = arg.split('=', 2);
 
             options[option] = value;
@@ -25,11 +29,14 @@ export function parse(args) {
     return { command, options };
 }
 
-export async function agree(string) {
-    process.stdout.write(string);
+export async function agree(string, { stdin = null, stdout = null } = {}) {
+    stdout = stdout ?? process.stdout;
+    stdin = stdin ?? process.stdin;
 
-    const answer = await new Promise((resolve, reject) => {
-        process.stdin.on('data', data => resolve(data));
+    stdout.write(string);
+
+    const answer = await new Promise((resolve) => {
+        stdin.on('data', data => resolve(data));
     });
 
     return ['y', 'yes'].includes(`${answer}`.trim().toLowerCase());
@@ -67,7 +74,6 @@ export class Table {
                 const width = ansi.strip(cell).length
                 const padding = Math.max(0, this.columns[i].width - width - 2);
                 const paddingString = (new Array(padding + 1)).join(' ');
-                const borderString = (new Array(this.columns[i].width + 1).join('-'));
 
                 return `${row || ''}${ansi.gray('|')} ${cell}${paddingString} ${i === r.length - 1 ? ansi.gray('|') : ''}`
             }, '');

package/src/config.js

@@ -1,5 +1,6 @@
 import fs from 'node:fs';
 import path from 'node:path';
+import { parse } from 'yaml';
 
 // Cached config object. The config is stored in here so it can
 // be loaded once and imported across all modules.
@@ -13,10 +14,15 @@ let config = {};
 export function locate() {
     for (let dir = process.cwd(); dir != '/'; dir = path.dirname(dir)) {
         const configPath = path.join(dir, 'frak.config.js');
+        const yamlPath = path.join(dir, '.frak');
 
         if (fs.existsSync(configPath)) {
             return configPath;
         }
+
+        if (fs.existsSync(yamlPath)) {
+            return yamlPath;
+        }
     }
 
     return null;
@@ -30,21 +36,51 @@ export function locate() {
 export async function load(env = null) {
     const configPath = locate();
 
-    if (fs.existsSync(configPath)) {
+    if (!fs.existsSync(configPath)) {
+        throw new Error('Config file not found! Try running frak init.');
+    }
+
+    if (path.basename(configPath) === 'frak.config.js') {
         Object.assign(config, (await import(configPath)).default);
+    } else if (path.basename(configPath) === '.frak') {
+        Object.assign(config, parse(fs.readFileSync(configPath).toString('utf-8')));
+    }
 
-        if (env in config) {
-            return Object.assign(config, {...config[env]});
-        }
+    if (env in config) {
+        Object.assign(config, {...config[env]});
 
-        if (env) {
-            throw new Error(`Missing configuration for environment "${env}"!`);
-        }
+        delete config[env];
 
         return config;
     }
 
-    throw new Error('Config file not found! Try running frak init.');
+    if (env) {
+        throw new Error(`Missing configuration for environment "${env}"!`);
+    }
+
+    // Support legacy config, remote_path instead of root
+    if ('remote_path' in config) {
+        config.root = config.remote_path;
+
+        delete config.remote_path;
+    }
+
+    return config;
+}
+
+/**
+ * Reset the config, useful when unit testing.
+ *
+ * @returns {Object}
+ */
+export function reset() {
+    const old = { ...config };
+
+    Object.entries(config).forEach(([key]) => {
+        delete config[key];
+    });
+
+    return old;
 }
 
 export default config;

package/src/date.js

@@ -54,7 +54,7 @@ export function relative(date) {
         value = Math.floor(seconds / 60 / 60 / 24 / 30);
         unit = plural('month', value);
     } else {
-        return `${months[datetime.getMonth()]} ${datetime.getDay()}, ${datetime.getFullYear()} @ ${datetime.getHours() % 12}:${`0${datetime.getMinutes()}`.slice(-2)} ${datetime.getHours() >= 12 ? 'pm' : 'am'}`;
+        return `${months[datetime.getMonth()]} ${datetime.getDate()}, ${datetime.getFullYear()} @ ${datetime.getHours() % 12}:${`0${datetime.getMinutes()}`.slice(-2)} ${datetime.getHours() >= 12 ? 'pm' : 'am'}`;
     }
 
     return `${value} ${unit} ${agoOrFromNow}`.trim();

package/src/debug.js

@@ -5,6 +5,6 @@ import * as ansi from '../src/ansi.js';
  */
 export default function debug() {
     if (process.env.DEBUG) {
-        console.log.apply(console, [ansi.bold(ansi.cyan('DEBUG:')), ...arguments]);
+        console.log.apply(console, [ ansi.bold(ansi.cyan('DEBUG:')), ...arguments ]);
     }
 }

package/src/diff.js

@@ -1,6 +1,7 @@
 import { spawn } from 'node:child_process';
 import { statSync } from 'node:fs';
 import * as ansi from './ansi.js';
+import * as cli from './cli.js';
 import config from './config.js';
 import debug from './debug.js';
 
@@ -21,8 +22,8 @@ export default async function diff(dryRunOutput, options) {
 
             let file, target;
 
-            // Links also have a target
-            if (action === 'cL+++++++++' || action === 'cLc.T......') {
+            // Links also have a target, cL+++++++++ or cLc.T......
+            if (action.match(/^cL.+/)) {
                 const index = parts.indexOf('->');
 
                 debug({ parts })
@@ -35,64 +36,68 @@ export default async function diff(dryRunOutput, options) {
 
             return [action, file, target];
         })
-        .filter(([action, file]) => file.slice(-1) !== '/');
+        .filter(([, file]) => file.slice(-1) !== '/');
 
     debug({ changes })
 
     let proceed = true;
 
     if (changes.length >= 50 && options.interactive) {
-        proceed = await cli.agree(ansi.yellow(`${changes.length} file(s) will be compared. Continue?`))
+        proceed = await cli.agree(ansi.yellow(`${changes.length} file(s) will be compared. Continue? `))
     }
 
     if (!proceed) {
         return Promise.reject('Process canceled by user');
     }
 
-    const files = changes.map(([action, file]) => file);
+    const files = changes.map(([, file]) => file);
 
     const diffs = changes.sort((a, b) => a[1].localeCompare(b[1])).map(change => {
         const [action, file] = change;
+
+        // Escape double quotes in file
+        const fileEscaped = file.replace(/"/g, '\\"');
+
         const header = [
-            `diff --git a/${file} b/${file}`,
+            file.match(/"/) ? `diff --git "a/${fileEscaped}" "b/${fileEscaped}"` : `diff --git a/${file} b/${file}`,
         ];
 
-        let diff = [];
+        let diff = '';
 
         if (action === '*deleting') {
             header.push('deleted file mode 100644');
             header.push('index 0000000..0000000');
 
-            diff = ['diff', '-Naurp', `--label=a/${file}`, `--label=/dev/null`, file, '/dev/null'];
-        } else if (action === '<f+++++++++') {
+            diff = `diff -Naurp --label="a/${fileEscaped}" --label=/dev/null "${fileEscaped}" /dev/null`;
+        } else if (action.match(/^<f\++/)) {
             const { mode } = statSync(file);
 
             header.push(`new file mode ${mode.toString(8)}`);
             header.push('index 0000000..0000000');
 
-            diff = ['diff', '-Naurp', `--label=/dev/null`, `--label=b/${file}`, '/dev/null', `<(tar xzOf $tarball --warning=no-unknown-keyword ${file} || cat /dev/null)`];
-        } else if (action === 'cLc.T......') {
+            diff = `diff -Naurp --label=/dev/null --label="b/${fileEscaped}" /dev/null <(tar xzOf $tarball "${fileEscaped}" || cat /dev/null)`;
+        } else if (action.match(/^cL\++/)) {
             const target = change[2];
 
+            header.push('new file mode 120000');
             header.push('index 0000000..0000000');
 
-            diff = ['diff', '-Naurp', `--label=a/${file}`, `--label=b/${file}`, `<(printf %s $(readlink ${file}))`, `<(printf %s ${target})`];
-        } else if (action === 'cL+++++++++') {
+            diff = `diff -Naurp --label=/dev/null --label="b/${fileEscaped}" /dev/null <(printf %s "${target}")`;
+        } else if (action.match(/^cL.+/)) {
             const target = change[2];
 
-            header.push('new file mode 120000');
             header.push('index 0000000..0000000');
 
-            diff = ['diff', '-Naurp', `--label=/dev/null`, `--label=b/${file}`, '/dev/null', `<(printf %s ${target})`];
+            diff = `diff -Naurp --label="a/${fileEscaped}" --label="b/${fileEscaped}" <(printf %s "$(readlink "${fileEscaped}")") <(printf %s "${target}")`;
         } else {
             const { mode } = statSync(file);
 
             header.push(`index 0000000..0000000  ${mode.toString(8)}`);
 
-            diff = ['diff', '-Naurp', `--label=a/${file}`, `--label=b/${file}`, file, `<(tar xzOf $tarball --warning=no-unknown-keyword ${file} || cat /dev/null)`];
+            diff = `diff -Naurp --label="a/${fileEscaped}" --label="b/${fileEscaped}" "${fileEscaped}" <(tar xzOf $tarball "${fileEscaped}" || cat /dev/null)`;
         }
 
-        return [`printf "%s\\n" "${header.join('\n')}"`, ';', ...diff, ';'];
+        return `printf "%s\\n" '${header.join('\n')}'; ${diff}`;
     });
 
     if (diffs.length > 0) {
@@ -103,19 +108,18 @@ export default async function diff(dryRunOutput, options) {
         const ssh = spawn('ssh', [
             config.server,
             '--',
-            'tarball=$(mktemp /tmp/frak-diff-tarball.XXXXXXXX);',
+            'tarball=$(mktemp /tmp/frak-diff-tarball.XXXXXX);',
             'cat > $tarball;',
             `cd ${config.root};`,
-            ...diffs.reduce((commands, diff) => commands.concat(...diff), []),
-            // `${diffs.join(';')};`,
-            // 'rm $tarball',
+            diffs.join('; '), ';',
+            'rm $tarball',
         ])
         tar.stdout.pipe(ssh.stdin);
 
         let less;
 
         if (options.interactive) {
-            less = spawn('less', ['-r'], { stdio: ['pipe', 'inherit', 'inherit'] });
+            less = spawn('less', ['-R'], { stdio: ['pipe', process.stdout, process.stderr] });
         }
 
         if (options.interactive && options.colorize) {
@@ -149,25 +153,31 @@ export default async function diff(dryRunOutput, options) {
                 less.on('exit', (code) => {
                     if (code === 0) {
                         resolve();
+                    /* node:coverage disable */
                     } else {
                         reject(`exited with code ${code}`);
                     }
+                    /* node:coverage enable */
                 });
             });
+        /* node:coverage disable */
         } else {
-            return await new Promise((resolve, reject) => {
+            return await new Promise((resolve) => {
                 let diff = '';
 
                 ssh.stdout.on('data', (data) => diff += data);
 
                 ssh.stderr.pipe(process.stderr);
 
-                ssh.on('exit', (code) => {
+                ssh.on('exit', () => {
                     resolve(diff);
                 });
             });
         }
+        /* node:coverage enable */
     } else if (options.interactive) {
         console.log(ansi.yellow('No changes detected.'));
     }
+
+    return '';
 }

package/src/humanize.js

@@ -9,5 +9,5 @@ export default function humanize(changes) {
         .replace(/<fc..\.\.\.\.\.\./g,    ansi.yellow('Update     '))
         .replace(/>fc..\.\.\.\.\.\./g,    ansi.yellow('Update     '))
         .replace(/cLc\.T\.\.\.\.\.\./g,   ansi.yellow('Update     '))
-        .replace(/\*deleting  /g,            ansi.red('Delete     '))
+        .replace(/\*deleting {2}/g,          ansi.red('Delete     '))
 }

package/src/rsync.js

@@ -19,6 +19,7 @@ export function filters() {
         '.git*',
         '.svn*',
         '.tags*',
+        'frak.config.js',
         'Capfile',
         'Gemfile*',
         'Vagrantfile*',
@@ -31,7 +32,8 @@ export function filters() {
 
     // merge path
     if (options.path) {
-        const paths = options.path.split(/ +/)
+        const paths = options.path.split(/((?<!\\) )+/)
+            .map(p => p.replace(/\\ /g, ' '))
             .map(p => path.resolve(p))
             .map(p => p) // TODO glob // paths.map! { |p| p[/[*?]/] ? Dir.glob(p) : p }
             .flat(Infinity)
@@ -136,9 +138,11 @@ export function exec(...options) {
         output += `${data}`;
     });
 
+    /* node:coverage disable */
     rsync.stderr.on('data', (data) => {
         process.stderr.write(`${data}`); // Print any errors from the child process
     });
+    /* node:coverage enable */
 
     return new Promise((resolve, reject) => {
         rsync.on('exit', (code) => {
@@ -147,9 +151,11 @@ export function exec(...options) {
                     output,
                     backupPath,
                 });
+            /* node:coverage disable */
             } else {
                 reject(`rsync exited with code ${code}`);
             }
+            /* node:coverage enable */
         });
     });
 }

package/src/ssh.js

@@ -31,9 +31,11 @@ export function exec(command, options = {}) {
         ssh.on('exit', (code) => {
             if (code === 0) {
                 resolve();
+            /* node:coverage disable */
             } else {
                 reject(`exited with code ${code}`);
             }
+            /* node:coverage enable */
         });
     });
 

package/eslint.config.js

@@ -1 +0,0 @@
-export default [{}]

package/frak.config.js

@@ -1,10 +0,0 @@
-export default {
-    server: 'franklinstrube.com',
-    root: '/home/ash/frak',
-    after: 'touch deployed; pwd',
-    method: 'rsync',
-
-    production: {
-        root: '/home/ash/frak-production',
-    },
-};