@wyxos/zephyr 0.2.20 → 0.2.22

package/README.md

@@ -1,145 +1,145 @@
-# @wyxos/zephyr
-
-A streamlined deployment tool for web applications with intelligent Laravel project detection.
-
-## Installation
-
-```bash
-npm install -g @wyxos/zephyr
-```
-
-Or run directly with npx:
-
-```bash
-npx @wyxos/zephyr
-```
-
-## Usage
-
-Navigate to your project directory and run:
-
-```bash
-zephyr
-```
-
-See all flags:
-
-```bash
-zephyr --help
-```
-
-Common flags:
-
-```bash
-# Run a release workflow
-zephyr --type node
-
-# Skip the best-effort update check for this run
-zephyr --skip-version-check
-```
-
-Follow the interactive prompts to configure your deployment target:
-- Server name and IP address
-- Project path on the remote server
-- Git branch to deploy
-- SSH user and private key
-
-Configuration is saved automatically for future deployments.
-
-## Update Checks
-
-When run via `npx`, Zephyr can prompt to re-run itself using the latest published version.
-
-- **Skip update check**:
-  - Set `ZEPHYR_SKIP_VERSION_CHECK=1`, or
-  - Use `zephyr --skip-version-check`
-
-## Features
-
-- Automated Git operations (branch switching, commits, pushes)
-- SSH-based deployment to remote servers
-- Laravel project detection with smart task execution
-- Intelligent dependency management (Composer, npm)
-- Database migrations when detected
-- Frontend asset compilation
-- Cache clearing and queue worker management
-- SSH key validation and management
-- Deployment locking to prevent concurrent runs
-- Task snapshots for resuming failed deployments
-- Comprehensive logging of all remote operations
-
-## Smart Task Execution
-
-Zephyr analyzes changed files and runs appropriate tasks:
-
-- **Always**: `git pull origin <branch>`
-- **Composer files changed** (`composer.json` / `composer.lock`): `composer update --no-dev --no-interaction --prefer-dist`
-- **Migrations changed** (`database/migrations/*.php`): `php artisan migrate --force`
-- **Node dependency files changed** (`package.json` / `package-lock.json`, including nested): `npm install`
-- **Frontend files changed** (`.vue/.js/.ts/.tsx/.css/.scss/.less`): `npm run build`
-  - Note: `npm run build` is also scheduled when `npm install` is scheduled.
-- **PHP files changed**: clear caches + restart queue workers (Horizon if configured)
-
-## Configuration
-
-### Global Server Configuration
-
-Servers are stored globally at `~/.config/zephyr/servers.json`:
-
-```json
-[
-  {
-    "id": "server_abc123",
-    "serverName": "production",
-    "serverIp": "192.168.1.100"
-  }
-]
-```
-
-### Project Configuration
-
-Deployment targets are stored per-project at `.zephyr/config.json`:
-
-```json
-{
-  "presets": [
-    {
-      "name": "prod-main",
-      "appId": "app_def456",
-      "branch": "main"
-    }
-  ],
-  "apps": [
-    {
-      "id": "app_def456",
-      "serverId": "server_abc123",
-      "serverName": "production",
-      "projectPath": "~/webapps/myapp",
-      "branch": "main",
-      "sshUser": "forge",
-      "sshKey": "~/.ssh/id_rsa"
-    }
-  ]
-}
-```
-
-### Project Directory Structure
-
-Zephyr creates a `.zephyr/` directory in your project with:
-- `config.json` - Project deployment configuration
-- `deploy.lock` - Lock file to prevent concurrent deployments
-- `pending-tasks.json` - Task snapshot for resuming failed deployments
-- `{timestamp}.log` - Log files for each deployment run
-
-The `.zephyr/` directory is automatically added to `.gitignore`.
-
-## Notes
-
-- If Zephyr reports **"No upstream file changes detected"**, it means the remote repository already matches `origin/<branch>` after `git fetch`. In that case, Zephyr will only run `git pull` and skip all conditional maintenance tasks.
-- If Zephyr prompts to update local file dependencies (path-based deps outside the repo), it may also prompt to commit those updates before continuing.
-
-## Requirements
-
-- Node.js 16+
-- Git
+# @wyxos/zephyr
+
+A streamlined deployment tool for web applications with intelligent Laravel project detection.
+
+## Installation
+
+```bash
+npm install -g @wyxos/zephyr
+```
+
+Or run directly with npx:
+
+```bash
+npx @wyxos/zephyr
+```
+
+## Usage
+
+Navigate to your project directory and run:
+
+```bash
+zephyr
+```
+
+See all flags:
+
+```bash
+zephyr --help
+```
+
+Common flags:
+
+```bash
+# Run a release workflow
+zephyr --type node
+
+# Skip the best-effort update check for this run
+zephyr --skip-version-check
+```
+
+Follow the interactive prompts to configure your deployment target:
+- Server name and IP address
+- Project path on the remote server
+- Git branch to deploy
+- SSH user and private key
+
+Configuration is saved automatically for future deployments.
+
+## Update Checks
+
+When run via `npx`, Zephyr can prompt to re-run itself using the latest published version.
+
+- **Skip update check**:
+  - Set `ZEPHYR_SKIP_VERSION_CHECK=1`, or
+  - Use `zephyr --skip-version-check`
+
+## Features
+
+- Automated Git operations (branch switching, commits, pushes)
+- SSH-based deployment to remote servers
+- Laravel project detection with smart task execution
+- Intelligent dependency management (Composer, npm)
+- Database migrations when detected
+- Frontend asset compilation
+- Cache clearing and queue worker management
+- SSH key validation and management
+- Deployment locking to prevent concurrent runs
+- Task snapshots for resuming failed deployments
+- Comprehensive logging of all remote operations
+
+## Smart Task Execution
+
+Zephyr analyzes changed files and runs appropriate tasks:
+
+- **Always**: `git pull origin <branch>`
+- **Composer files changed** (`composer.json` / `composer.lock`): `composer update --no-dev --no-interaction --prefer-dist`
+- **Migrations changed** (`database/migrations/*.php`): `php artisan migrate --force`
+- **Node dependency files changed** (`package.json` / `package-lock.json`, including nested): `npm install`
+- **Frontend files changed** (`.vue/.js/.ts/.tsx/.css/.scss/.less`): `npm run build`
+  - Note: `npm run build` is also scheduled when `npm install` is scheduled.
+- **PHP files changed**: clear caches + restart queue workers (Horizon if configured)
+
+## Configuration
+
+### Global Server Configuration
+
+Servers are stored globally at `~/.config/zephyr/servers.json`:
+
+```json
+[
+  {
+    "id": "server_abc123",
+    "serverName": "production",
+    "serverIp": "192.168.1.100"
+  }
+]
+```
+
+### Project Configuration
+
+Deployment targets are stored per-project at `.zephyr/config.json`:
+
+```json
+{
+  "presets": [
+    {
+      "name": "prod-main",
+      "appId": "app_def456",
+      "branch": "main"
+    }
+  ],
+  "apps": [
+    {
+      "id": "app_def456",
+      "serverId": "server_abc123",
+      "serverName": "production",
+      "projectPath": "~/webapps/myapp",
+      "branch": "main",
+      "sshUser": "forge",
+      "sshKey": "~/.ssh/id_rsa"
+    }
+  ]
+}
+```
+
+### Project Directory Structure
+
+Zephyr creates a `.zephyr/` directory in your project with:
+- `config.json` - Project deployment configuration
+- `deploy.lock` - Lock file to prevent concurrent deployments
+- `pending-tasks.json` - Task snapshot for resuming failed deployments
+- `{timestamp}.log` - Log files for each deployment run
+
+The `.zephyr/` directory is automatically added to `.gitignore`.
+
+## Notes
+
+- If Zephyr reports **"No upstream file changes detected"**, it means the remote repository already matches `origin/<branch>` after `git fetch`. In that case, Zephyr will only run `git pull` and skip all conditional maintenance tasks.
+- If Zephyr prompts to update local file dependencies (path-based deps outside the repo), it may also prompt to commit those updates before continuing.
+
+## Requirements
+
+- Node.js 16+
+- Git
 - SSH access to target servers

package/bin/zephyr.mjs

@@ -1,30 +1,30 @@
 #!/usr/bin/env node
-import process from 'node:process'
-import { Command } from 'commander'
-import chalk from 'chalk'
-import { main } from '../src/main.mjs'
-import { createChalkLogger } from '../src/utils/output.mjs'
-
-const { logError } = createChalkLogger(chalk)
-
-const program = new Command()
-
-program
-  .name('zephyr')
-  .description('A streamlined deployment tool for web applications with intelligent Laravel project detection')
-  .option('--type <type>', 'Release type (node|vue|packagist)')
-  .option('--skip-version-check', 'Skip the version check for this run')
-
-program.parse(process.argv)
-const options = program.opts()
-
-if (options.skipVersionCheck) {
-  process.env.ZEPHYR_SKIP_VERSION_CHECK = '1'
-}
-
-try {
-  await main(options.type ?? null)
-} catch (error) {
-  logError(error?.message || String(error))
-  process.exitCode = 1
-}
+import process from 'node:process'
+import { Command } from 'commander'
+import chalk from 'chalk'
+import { main } from '../src/main.mjs'
+import { createChalkLogger } from '../src/utils/output.mjs'
+
+const { logError } = createChalkLogger(chalk)
+
+const program = new Command()
+
+program
+  .name('zephyr')
+  .description('A streamlined deployment tool for web applications with intelligent Laravel project detection')
+  .option('--type <type>', 'Release type (node|vue|packagist)')
+  .option('--skip-version-check', 'Skip the version check for this run')
+
+program.parse(process.argv)
+const options = program.opts()
+
+if (options.skipVersionCheck) {
+  process.env.ZEPHYR_SKIP_VERSION_CHECK = '1'
+}
+
+try {
+  await main(options.type ?? null)
+} catch (error) {
+  logError(error?.message || String(error))
+  process.exitCode = 1
+}

package/package.json

@@ -1,58 +1,58 @@
-{
-  "name": "@wyxos/zephyr",
-  "version": "0.2.20",
-  "description": "A streamlined deployment tool for web applications with intelligent Laravel project detection",
-  "type": "module",
-  "main": "./src/index.mjs",
-  "exports": {
-    ".": "./src/index.mjs",
-    "./ssh": "./src/ssh/index.mjs"
-  },
-  "bin": {
-    "zephyr": "bin/zephyr.mjs"
-  },
-  "scripts": {
-    "test": "vitest run",
-    "lint": "eslint .",
-    "release": "node bin/zephyr.mjs --type=node"
-  },
-  "keywords": [
-    "deployment",
-    "laravel",
-    "ssh",
-    "automation",
-    "devops",
-    "git"
-  ],
-  "author": "wyxos",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/wyxos/zephyr.git"
-  },
-  "bugs": {
-    "url": "https://github.com/wyxos/zephyr/issues"
-  },
-  "homepage": "https://github.com/wyxos/zephyr#readme",
-  "engines": {
-    "node": ">=16.0.0"
-  },
-  "files": [
-    "bin/",
-    "src/",
-    "README.md"
-  ],
-  "dependencies": {
-    "chalk": "5.3.0",
-    "commander": "11.1.0",
-    "inquirer": "^9.2.12",
-    "node-ssh": "^13.1.0",
-    "semver": "^7.6.3"
-  },
-  "devDependencies": {
-    "@eslint/js": "^9.39.2",
-    "eslint": "^9.39.2",
-    "globals": "^17.0.0",
-    "vitest": "^2.1.8"
-  }
-}
+{
+  "name": "@wyxos/zephyr",
+  "version": "0.2.22",
+  "description": "A streamlined deployment tool for web applications with intelligent Laravel project detection",
+  "type": "module",
+  "main": "./src/index.mjs",
+  "exports": {
+    ".": "./src/index.mjs",
+    "./ssh": "./src/ssh/index.mjs"
+  },
+  "bin": {
+    "zephyr": "bin/zephyr.mjs"
+  },
+  "scripts": {
+    "test": "vitest run",
+    "lint": "eslint .",
+    "release": "node bin/zephyr.mjs --type=node"
+  },
+  "keywords": [
+    "deployment",
+    "laravel",
+    "ssh",
+    "automation",
+    "devops",
+    "git"
+  ],
+  "author": "wyxos",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wyxos/zephyr.git"
+  },
+  "bugs": {
+    "url": "https://github.com/wyxos/zephyr/issues"
+  },
+  "homepage": "https://github.com/wyxos/zephyr#readme",
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "README.md"
+  ],
+  "dependencies": {
+    "chalk": "5.3.0",
+    "commander": "11.1.0",
+    "inquirer": "^9.2.12",
+    "node-ssh": "^13.1.0",
+    "semver": "^7.6.3"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.2",
+    "eslint": "^9.39.2",
+    "globals": "^17.0.0",
+    "vitest": "^2.1.8"
+  }
+}