@wyxos/zephyr 0.1.11 → 0.1.13

package/README.md

@@ -1,76 +1,105 @@
-# @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
-```
-
-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 to `release.json` for future deployments.
-
-## 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
-
-## Smart Task Execution
-
-Zephyr analyzes changed files and runs appropriate tasks:
-
-- **Always**: `git pull origin <branch>`
-- **Composer files changed**: `composer update`
-- **Migration files added**: `php artisan migrate`
-- **package.json changed**: `npm install`
-- **Frontend files changed**: `npm run build`
-- **PHP files changed**: Clear Laravel caches, restart queues
-
-## Configuration
-
-Deployment targets are stored in `release.json`:
-
-```json
-[
-  {
-    "serverName": "production",
-    "serverIp": "192.168.1.100",
-    "projectPath": "~/webapps/myapp",
-    "branch": "main",
-    "sshUser": "forge",
-    "sshKey": "~/.ssh/id_rsa"
-  }
-]
-```
-
-## 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
+```
+
+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.
+
+## 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 update --no-dev --no-interaction --prefer-dist`
+- **Migration files added**: `php artisan migrate --force`
+- **package.json changed**: `npm install`
+- **Frontend files changed**: `npm run build`
+- **PHP files changed**: Clear Laravel caches, restart queues
+
+## Configuration
+
+### Global Server Configuration
+
+Servers are stored globally at `~/.config/zephyr/servers.json`:
+
+```json
+[
+  {
+    "serverName": "production",
+    "serverIp": "192.168.1.100"
+  }
+]
+```
+
+### Project Configuration
+
+Deployment targets are stored per-project at `.zephyr/config.json`:
+
+```json
+{
+  "apps": [
+    {
+      "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`.
+
+## Requirements
+
+- Node.js 16+
+- Git
 - SSH access to target servers

package/bin/zephyr.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-import { main } from '../src/index.mjs'
-
-main().catch((error) => {
-  console.error(error.message)
-  process.exit(1)
-})
+import { main } from '../src/index.mjs'
+
+main().catch((error) => {
+  console.error(error.message)
+  process.exit(1)
+})

package/package.json

@@ -1,48 +1,48 @@
-{
-  "name": "@wyxos/zephyr",
-  "version": "0.1.11",
-  "description": "A streamlined deployment tool for web applications with intelligent Laravel project detection",
-  "type": "module",
-  "main": "./src/index.mjs",
-  "bin": {
-    "zephyr": "bin/zephyr.mjs"
-  },
-  "scripts": {
-    "test": "vitest",
-    "release": "node publish.mjs"
-  },
-  "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",
-    "inquirer": "^9.2.12",
-    "node-ssh": "^13.1.0"
-  },
-  "devDependencies": {
-    "vitest": "^2.1.8"
-  }
-}
+{
+  "name": "@wyxos/zephyr",
+  "version": "0.1.13",
+  "description": "A streamlined deployment tool for web applications with intelligent Laravel project detection",
+  "type": "module",
+  "main": "./src/index.mjs",
+  "bin": {
+    "zephyr": "bin/zephyr.mjs"
+  },
+  "scripts": {
+    "test": "vitest",
+    "release": "node publish.mjs"
+  },
+  "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",
+    "inquirer": "^9.2.12",
+    "node-ssh": "^13.1.0"
+  },
+  "devDependencies": {
+    "vitest": "^2.1.8"
+  }
+}