@wyxos/zephyr 0.5.0 → 0.7.4

package/README.md

@@ -40,12 +40,21 @@ Common workflows:
 # Deploy an app using the saved preset or the interactive prompts
 zephyr
 
-# Deploy an app and bump the local npm package version first
+# Deploy an app with a local npm package version bump
 zephyr minor
 
+# Deploy an app while bypassing Zephyr's built-in local checks
+zephyr minor --skip-checks
+
 # Deploy a configured app non-interactively
 zephyr --non-interactive --preset wyxos-release --maintenance off
 
+# Deploy a configured app non-interactively and auto-commit dirty changes
+zephyr --non-interactive --preset wyxos-release --auto-commit
+
+# Deploy without mutating the local package version
+zephyr --non-interactive --preset wyxos-release --skip-versioning
+
 # Resume a pending non-interactive deployment
 zephyr --non-interactive --preset wyxos-release --resume-pending --maintenance off
 
@@ -60,6 +69,10 @@ zephyr --type node minor
 
 # Release a Packagist package
 zephyr --type packagist patch
+
+# Release the current package/composer version without bumping version files
+zephyr --type node --skip-versioning
+zephyr --type packagist --skip-versioning
 ```
 
 When `--type node` or `--type vue` is used without a bump argument, Zephyr defaults to `patch`.
@@ -74,7 +87,7 @@ Non-interactive mode is strict and is intended for already-configured projects:
 
 - `--non-interactive` fails instead of prompting
 - app deployments require `--preset <name>`
-- Laravel app deployments require `--maintenance on|off` unless resuming a saved snapshot that already contains the choice
+- Laravel app deployments require either a saved preset maintenance preference, `--maintenance on|off`, or a resumable snapshot that already contains the choice
 - pending deployment snapshots require either `--resume-pending` or `--discard-pending`
 - stale remote locks are never auto-removed in non-interactive mode
 - `--json` is only supported together with `--non-interactive`
@@ -91,7 +104,11 @@ If Zephyr would normally prompt to:
 
 then non-interactive mode stops immediately with a clear error instead.
 
-For Laravel app deployments, `--maintenance on|off` overrides the maintenance prompt when you want an explicit choice instead of an interactive confirm.
+For Laravel app deployments, `--maintenance on|off` overrides both the saved preset preference and the maintenance prompt when you want an explicit choice for the current run.
+
+`--auto-commit` is available for app deployments and tells Zephyr to let local Codex inspect the repo and generate the dirty-tree commit message instead of prompting for one.
+
+`--skip-versioning` keeps Zephyr from mutating `package.json` or `composer.json`. On app deploys it skips the local npm version bump step. On package release workflows it releases the version already present in the manifest and creates the release tag from the current `HEAD`.
 
 ## AI Agents and Automation
 
@@ -155,6 +172,8 @@ npm run release
 - `npm run release` is the recommended app/package entrypoint once the release script has been installed.
 - For `--type node` workflows, Zephyr runs your project's `lint` script when present.
 - For `--type node` workflows, Zephyr runs `test:run` or `test` when present.
+- For fresh Laravel app deploys, Zephyr runs local lint/test checks before creating the version-bump commit so failed checks do not force repeated bump retries.
+- For critical app deploys, `--skip-checks` is shorthand for `--skip-lint --skip-tests`. It skips Zephyr's built-in local checks, but any local `pre-push` hook can still run its own checks during git push unless you also opt into `--skip-git-hooks`.
 - For non-interactive app deploys, use a saved preset name instead of relying on prompt fallback.
 
 ## Features
@@ -209,7 +228,15 @@ Deployment targets are stored per-project at `.zephyr/config.json`:
     {
       "name": "prod-main",
       "appId": "app_def456",
-      "branch": "main"
+      "branch": "main",
+      "options": {
+        "maintenanceMode": true,
+        "skipGitHooks": false,
+        "skipTests": false,
+        "skipLint": false,
+        "skipVersioning": false,
+        "autoCommit": true
+      }
     }
   ],
   "apps": [
@@ -226,6 +253,8 @@ Deployment targets are stored per-project at `.zephyr/config.json`:
 }
 ```
 
+Preset `options` capture repeatable deploy behavior so Zephyr can reuse the same maintenance, dirty-tree, and deploy-check preferences on later runs.
+
 ### Project Directory Structure
 
 Zephyr creates a `.zephyr/` directory in your project with:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wyxos/zephyr",
-  "version": "0.5.0",
+  "version": "0.7.4",
   "description": "A streamlined deployment tool for web applications with intelligent Laravel project detection",
   "type": "module",
   "main": "./src/index.mjs",

package/src/application/configuration/preset-selection.mjs

@@ -23,12 +23,6 @@ export async function selectPreset({
                 const branch = preset.branch || app.branch || 'unknown'
                 displayName = `${preset.name} (${serverName} → ${app.projectPath} [${branch}])`
             }
-        } else if (preset.key) {
-            const keyParts = preset.key.split(':')
-            const serverName = keyParts[0]
-            const projectPath = keyParts[1]
-            const branch = preset.branch || (keyParts.length === 3 ? keyParts[2] : 'unknown')
-            displayName = `${preset.name} (${serverName} → ${projectPath} [${branch}])`
         }
 
         return {

package/src/application/configuration/select-deployment-target.mjs

@@ -1,6 +1,11 @@
 import {writeStdoutLine} from '../../utils/output.mjs'
 import {loadServers} from '../../config/servers.mjs'
 import {loadProjectConfig, removePreset, saveProjectConfig} from '../../config/project.mjs'
+import {
+    buildPresetOptionsFromExecutionMode,
+    normalizePresetOptions,
+    presetOptionsEqual
+} from '../../config/preset-options.mjs'
 import {ZephyrError} from '../../runtime/errors.mjs'
 
 function findPresetByName(projectConfig, presetName) {
@@ -8,6 +13,56 @@ function findPresetByName(projectConfig, presetName) {
     return presets.find((entry) => entry?.name === presetName) ?? null
 }
 
+function createPresetState(rootDir, projectConfig, preset, {
+    logSuccess
+} = {}) {
+    if (!preset) {
+        return null
+    }
+
+    return {
+        name: preset.name,
+        get options() {
+            return normalizePresetOptions(preset.options)
+        },
+        async saveOptions(nextOptions, {
+            message = null
+        } = {}) {
+            const normalizedOptions = normalizePresetOptions(nextOptions)
+
+            if (presetOptionsEqual(preset.options, normalizedOptions)) {
+                return false
+            }
+
+            preset.options = normalizedOptions
+            await saveProjectConfig(rootDir, projectConfig)
+
+            if (message) {
+                logSuccess?.(message)
+            }
+
+            return true
+        },
+        async applyExecutionMode(executionMode = {}) {
+            const nextOptions = buildPresetOptionsFromExecutionMode(executionMode, preset.options)
+            return await this.saveOptions(nextOptions)
+        }
+    }
+}
+
+async function promptPresetAutoCommit(runPrompt, enabledByDefault = false) {
+    const {autoCommitPreference} = await runPrompt([
+        {
+            type: 'input',
+            name: 'autoCommitPreference',
+            message: 'Enable auto-commit for dirty changes on this preset? Leave blank for manual commit prompts.',
+            default: enabledByDefault ? 'enabled' : ''
+        }
+    ])
+
+    return typeof autoCommitPreference === 'string' && autoCommitPreference.trim().length > 0
+}
+
 function resolvePresetNonInteractive(projectConfig, servers, preset, presetName) {
     if (!preset) {
         throw new ZephyrError(
@@ -18,8 +73,8 @@ function resolvePresetNonInteractive(projectConfig, servers, preset, presetName)
 
     if (!preset.appId) {
         throw new ZephyrError(
-            `Zephyr cannot run non-interactively because preset "${preset.name || presetName}" uses a legacy or invalid format. Rerun interactively once to repair .zephyr/config.json.`,
-            {code: 'ZEPHYR_PRESET_REPAIR_REQUIRED'}
+            `Zephyr cannot run non-interactively because preset "${preset.name || presetName}" is invalid.`,
+            {code: 'ZEPHYR_PRESET_INVALID'}
         )
     }
 
@@ -72,6 +127,7 @@ export async function selectDeploymentTarget(rootDir, {
 
     let server = null
     let appConfig = null
+    let activePreset = null
     let isCreatingNewPreset = false
 
     const preset = nonInteractive
@@ -95,11 +151,11 @@ export async function selectDeploymentTarget(rootDir, {
     }
 
     if (nonInteractive) {
+        activePreset = preset
         const resolved = resolvePresetNonInteractive(projectConfig, servers, preset, executionMode.presetName)
         server = resolved.server
-        appConfig = resolved.appConfig
         appConfig = {
-            ...appConfig,
+            ...resolved.appConfig,
             branch: resolved.branch
         }
     } else if (preset === 'create') {
@@ -107,64 +163,29 @@ export async function selectDeploymentTarget(rootDir, {
         server = await configurationService.selectServer(servers)
         appConfig = await configurationService.selectApp(projectConfig, server, rootDir)
     } else if (preset) {
-        if (preset.appId) {
-            appConfig = projectConfig.apps?.find((app) => app.id === preset.appId)
+        activePreset = preset
+        appConfig = projectConfig.apps?.find((app) => app.id === preset.appId)
 
-            if (!appConfig) {
-                logWarning?.('Preset references an application that no longer exists. Creating a new configuration instead.')
-                await removeInvalidPreset()
-                server = await configurationService.selectServer(servers)
-                appConfig = await configurationService.selectApp(projectConfig, server, rootDir)
-            } else {
-                server = servers.find((entry) => entry.id === appConfig.serverId || entry.serverName === appConfig.serverName)
-
-                if (!server) {
-                    logWarning?.('Preset references a server that no longer exists. Creating a new configuration instead.')
-                    await removeInvalidPreset()
-                    server = await configurationService.selectServer(servers)
-                    appConfig = await configurationService.selectApp(projectConfig, server, rootDir)
-                } else if (preset.branch && appConfig.branch !== preset.branch) {
-                    appConfig.branch = preset.branch
-                    await saveProjectConfig(rootDir, projectConfig)
-                    logSuccess?.(`Updated branch to ${preset.branch} from preset.`)
-                }
-            }
-        } else if (preset.key) {
-            const keyParts = preset.key.split(':')
-            const serverName = keyParts[0]
-            const projectPath = keyParts[1]
-            const presetBranch = preset.branch || (keyParts.length === 3 ? keyParts[2] : null)
-
-            server = servers.find((entry) => entry.serverName === serverName)
+        if (!appConfig) {
+            logWarning?.('Preset references an application that no longer exists. Creating a new configuration instead.')
+            await removeInvalidPreset()
+            activePreset = null
+            server = await configurationService.selectServer(servers)
+            appConfig = await configurationService.selectApp(projectConfig, server, rootDir)
+        } else {
+            server = servers.find((entry) => entry.id === appConfig.serverId || entry.serverName === appConfig.serverName)
 
             if (!server) {
-                logWarning?.(`Preset references server "${serverName}" which no longer exists. Creating a new configuration instead.`)
+                logWarning?.('Preset references a server that no longer exists. Creating a new configuration instead.')
                 await removeInvalidPreset()
+                activePreset = null
                 server = await configurationService.selectServer(servers)
                 appConfig = await configurationService.selectApp(projectConfig, server, rootDir)
-            } else {
-                appConfig = projectConfig.apps?.find(
-                    (app) => (app.serverId === server.id || app.serverName === serverName) && app.projectPath === projectPath
-                )
-
-                if (!appConfig) {
-                    logWarning?.('Preset references an application that no longer exists. Creating a new configuration instead.')
-                    await removeInvalidPreset()
-                    appConfig = await configurationService.selectApp(projectConfig, server, rootDir)
-                } else {
-                    preset.appId = appConfig.id
-                    if (presetBranch && appConfig.branch !== presetBranch) {
-                        appConfig.branch = presetBranch
-                    }
-                    preset.branch = appConfig.branch
-                    await saveProjectConfig(rootDir, projectConfig)
-                }
+            } else if (preset.branch && appConfig.branch !== preset.branch) {
+                appConfig.branch = preset.branch
+                await saveProjectConfig(rootDir, projectConfig)
+                logSuccess?.(`Updated branch to ${preset.branch} from preset.`)
             }
-        } else {
-            logWarning?.('Preset format is invalid. Creating a new configuration instead.')
-            await removeInvalidPreset()
-            server = await configurationService.selectServer(servers)
-            appConfig = await configurationService.selectApp(projectConfig, server, rootDir)
         }
     } else {
         server = await configurationService.selectServer(servers)
@@ -173,7 +194,7 @@ export async function selectDeploymentTarget(rootDir, {
 
     if (nonInteractive && (!appConfig?.sshUser || !appConfig?.sshKey)) {
         throw new ZephyrError(
-            `Zephyr cannot run non-interactively because preset "${preset?.name || executionMode.presetName}" is missing SSH details.`,
+            `Zephyr cannot run non-interactively because preset "${activePreset?.name || executionMode.presetName}" is missing SSH details.`,
             {code: 'ZEPHYR_SSH_DETAILS_REQUIRED'}
         )
     }
@@ -207,7 +228,7 @@ export async function selectDeploymentTarget(rootDir, {
         writeStdoutLine(JSON.stringify(deploymentConfig, null, 2))
     }
 
-    if (!nonInteractive && (isCreatingNewPreset || !preset)) {
+    if (!nonInteractive && (isCreatingNewPreset || !activePreset)) {
         const {presetName} = await runPrompt([
             {
                 type: 'input',
@@ -220,31 +241,47 @@ export async function selectDeploymentTarget(rootDir, {
         const trimmedName = presetName?.trim()
 
         if (trimmedName && trimmedName.length > 0) {
-            const presets = projectConfig.presets ?? []
             const appId = appConfig.id
 
             if (!appId) {
                 logWarning?.('Cannot save preset: app configuration missing ID.')
             } else {
-                const existingIndex = presets.findIndex((entry) => entry.appId === appId)
-
-                if (existingIndex >= 0) {
-                    presets[existingIndex].name = trimmedName
-                    presets[existingIndex].branch = deploymentConfig.branch
-                } else {
-                    presets.push({
-                        name: trimmedName,
-                        appId,
-                        branch: deploymentConfig.branch
-                    })
+                const existingPreset = findPresetByName(projectConfig, trimmedName)
+                const autoCommitEnabled = await promptPresetAutoCommit(
+                    runPrompt,
+                    executionMode.autoCommit === true || existingPreset?.options?.autoCommit === true
+                )
+                const nextPreset = existingPreset ?? {
+                    name: trimmedName,
+                    appId,
+                    branch: deploymentConfig.branch,
+                    options: normalizePresetOptions()
+                }
+
+                nextPreset.name = trimmedName
+                nextPreset.appId = appId
+                nextPreset.branch = deploymentConfig.branch
+                nextPreset.options = normalizePresetOptions({
+                    ...buildPresetOptionsFromExecutionMode(executionMode, nextPreset.options),
+                    autoCommit: autoCommitEnabled
+                })
+
+                if (!existingPreset) {
+                    projectConfig.presets = [...(projectConfig.presets ?? []), nextPreset]
                 }
 
-                projectConfig.presets = presets
                 await saveProjectConfig(rootDir, projectConfig)
                 logSuccess?.(`Saved preset "${trimmedName}" to .zephyr/config.json`)
+                activePreset = nextPreset
             }
         }
     }
 
-    return {deploymentConfig, projectConfig}
+    return {
+        deploymentConfig,
+        projectConfig,
+        presetState: createPresetState(rootDir, projectConfig, activePreset, {
+            logSuccess
+        })
+    }
 }

package/src/application/deploy/build-remote-deployment-plan.mjs

@@ -235,6 +235,7 @@ async function resolveMaintenanceMode({
                                          snapshot,
                                          remoteIsLaravel,
                                          runPrompt,
+                                         persistPresetOptions,
                                          executionMode = {}
                                      } = {}) {
     if (!remoteIsLaravel) {
@@ -269,7 +270,14 @@ async function resolveMaintenanceMode({
         }
     ])
 
-    return Boolean(answers?.enableMaintenanceMode)
+    const maintenanceModeEnabled = Boolean(answers?.enableMaintenanceMode)
+    await persistPresetOptions?.({
+        maintenanceMode: maintenanceModeEnabled
+    }, {
+        message: 'Saved maintenance mode preference to the selected preset.'
+    })
+
+    return maintenanceModeEnabled
 }
 
 async function resolveMaintenanceModePlan({
@@ -333,6 +341,7 @@ async function resolveMaintenanceModePlan({
 export async function resolveRemoteDeploymentState({
                                                        snapshot,
                                                        executionMode = {},
+                                                       persistPresetOptions,
                                                        ssh,
                                                        remoteCwd,
                                                        runPrompt,
@@ -351,6 +360,7 @@ export async function resolveRemoteDeploymentState({
         snapshot,
         remoteIsLaravel,
         runPrompt,
+        persistPresetOptions,
         executionMode
     })
 
@@ -365,6 +375,7 @@ export async function buildRemoteDeploymentPlan({
                                                     snapshot = null,
                                                     requiredPhpVersion = null,
                                                     executionMode = {},
+                                                    persistPresetOptions,
                                                     remoteIsLaravel = null,
                                                     maintenanceModeEnabled = null,
                                                     ssh,
@@ -384,6 +395,7 @@ export async function buildRemoteDeploymentPlan({
         : await resolveRemoteDeploymentState({
             snapshot,
             executionMode,
+            persistPresetOptions,
             ssh,
             remoteCwd,
             runPrompt,

package/src/application/deploy/plan-laravel-deployment-tasks.mjs

@@ -1,3 +1,24 @@
+const FRONTEND_BUILD_EXTENSIONS = [
+  '.vue',
+  '.css',
+  '.scss',
+  '.js',
+  '.jsx',
+  '.mjs',
+  '.cjs',
+  '.ts',
+  '.tsx',
+  '.less',
+  '.svg',
+  '.png',
+  '.jpg',
+  '.jpeg',
+  '.gif',
+  '.webp',
+  '.avif',
+  '.ico'
+]
+
 export function planLaravelDeploymentTasks({
   branch,
   isLaravel,
@@ -39,7 +60,7 @@ export function planLaravelDeploymentTasks({
   const hasFrontendChanges =
     isLaravel &&
     safeChangedFiles.some((file) =>
-      ['.vue', '.css', '.scss', '.js', '.ts', '.tsx', '.less'].some((ext) => file.endsWith(ext))
+      FRONTEND_BUILD_EXTENSIONS.some((ext) => file.endsWith(ext))
     )
 
   const shouldRunBuild = isLaravel && (hasFrontendChanges || shouldRunNpmInstall)
@@ -116,4 +137,4 @@ export function planLaravelDeploymentTasks({
   }
 
   return steps
-}
+}

package/src/application/deploy/prepare-local-deployment.mjs

@@ -10,6 +10,10 @@ export async function prepareLocalDeployment(config, {
     rootDir = process.cwd(),
     versionArg = null,
     skipGitHooks = false,
+    skipTests = false,
+    skipLint = false,
+    skipVersioning = false,
+    autoCommit = false,
     runPrompt,
     runCommand,
     runCommandCapture,
@@ -24,26 +28,51 @@ export async function prepareLocalDeployment(config, {
         logProcessing,
         logSuccess,
         logWarning,
-        skipGitHooks
+        skipGitHooks,
+        autoCommit
     })
 
     const context = await resolveLocalDeploymentContext(rootDir)
     const checkSupport = await resolveLocalDeploymentCheckSupport({
         rootDir,
         isLaravel: context.isLaravel,
+        skipTests,
+        skipLint,
         runCommandCapture
     })
 
     if (!snapshot && context.isLaravel) {
-        await bumpLocalPackageVersion(rootDir, {
-            versionArg,
+        await runLocalDeploymentChecks({
+            rootDir,
+            isLaravel: context.isLaravel,
+            hasHook: context.hasHook,
             skipGitHooks,
+            skipTests,
+            skipLint,
+            forceRunWhenHookPresent: true,
             runCommand,
+            runCommandCapture,
             logProcessing,
             logSuccess,
-            logWarning
+            logWarning,
+            lintCommand: checkSupport.lintCommand,
+            buildCommand: checkSupport.buildCommand,
+            testCommand: checkSupport.testCommand
         })
 
+        if (skipVersioning) {
+            logWarning?.('Skipping deployment version update because --skip-versioning flag was provided.')
+        } else {
+            await bumpLocalPackageVersion(rootDir, {
+                versionArg,
+                skipGitHooks,
+                runCommand,
+                logProcessing,
+                logSuccess,
+                logWarning
+            })
+        }
+
         await ensureCommittedChangesPushed(config.branch, rootDir, {
             runCommand,
             runCommandCapture,
@@ -52,6 +81,8 @@ export async function prepareLocalDeployment(config, {
             logWarning,
             skipGitHooks
         })
+
+        return context
     }
 
     await runLocalDeploymentChecks({
@@ -59,12 +90,15 @@ export async function prepareLocalDeployment(config, {
         isLaravel: context.isLaravel,
         hasHook: context.hasHook,
         skipGitHooks,
+        skipTests,
+        skipLint,
         runCommand,
         runCommandCapture,
         logProcessing,
         logSuccess,
         logWarning,
         lintCommand: checkSupport.lintCommand,
+        buildCommand: checkSupport.buildCommand,
         testCommand: checkSupport.testCommand
     })
 

package/src/application/deploy/run-deployment.mjs

@@ -248,7 +248,8 @@ export async function runDeployment(config, options = {}) {
         snapshot = null,
         rootDir = process.cwd(),
         versionArg = null,
-        context
+        context,
+        presetState = null
     } = options
 
     const {
@@ -366,6 +367,10 @@ export async function runDeployment(config, options = {}) {
             rootDir,
             versionArg,
             skipGitHooks: executionMode?.skipGitHooks === true,
+            skipTests: executionMode?.skipTests === true,
+            skipLint: executionMode?.skipLint === true,
+            skipVersioning: executionMode?.skipVersioning === true,
+            autoCommit: executionMode?.autoCommit === true,
             runPrompt,
             runCommand,
             runCommandCapture: context.runCommandCapture,
@@ -410,6 +415,7 @@ export async function runDeployment(config, options = {}) {
             rootDir,
             requiredPhpVersion,
             executionMode,
+            persistPresetOptions: presetState?.saveOptions,
             remoteIsLaravel: remoteState?.remoteIsLaravel,
             maintenanceModeEnabled: remoteState?.maintenanceModeEnabled,
             ssh,