@wyxos/zephyr 0.6.0 → 0.7.5

package/README.md

@@ -49,6 +49,12 @@ 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
 
@@ -63,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`.
@@ -77,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`
@@ -94,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
 
@@ -214,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": [
@@ -231,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.6.0",
+  "version": "0.7.5",
   "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'}
         )
     }
 
@@ -54,6 +109,7 @@ export async function selectDeploymentTarget(rootDir, {
     logSuccess,
     logWarning,
     emitEvent,
+    promptPresetOptions = true,
     executionMode = {}
 } = {}) {
     const nonInteractive = executionMode?.interactive === false
@@ -72,6 +128,7 @@ export async function selectDeploymentTarget(rootDir, {
 
     let server = null
     let appConfig = null
+    let activePreset = null
     let isCreatingNewPreset = false
 
     const preset = nonInteractive
@@ -95,11 +152,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 +164,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)
-
-            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)
+        activePreset = preset
+        appConfig = projectConfig.apps?.find((app) => app.id === preset.appId)
 
-            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 +195,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 +229,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 +242,48 @@ 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 nextPreset = existingPreset ?? {
+                    name: trimmedName,
+                    appId,
+                    branch: deploymentConfig.branch,
+                    options: normalizePresetOptions()
+                }
+                const nextOptions = buildPresetOptionsFromExecutionMode(executionMode, nextPreset.options)
+
+                if (promptPresetOptions) {
+                    nextOptions.autoCommit = await promptPresetAutoCommit(
+                        runPrompt,
+                        executionMode.autoCommit === true || existingPreset?.options?.autoCommit === true
+                    )
+                }
+
+                nextPreset.name = trimmedName
+                nextPreset.appId = appId
+                nextPreset.branch = deploymentConfig.branch
+                nextPreset.options = normalizePresetOptions(nextOptions)
+
+                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

@@ -12,6 +12,8 @@ export async function prepareLocalDeployment(config, {
     skipGitHooks = false,
     skipTests = false,
     skipLint = false,
+    skipVersioning = false,
+    autoCommit = false,
     runPrompt,
     runCommand,
     runCommandCapture,
@@ -26,7 +28,8 @@ export async function prepareLocalDeployment(config, {
         logProcessing,
         logSuccess,
         logWarning,
-        skipGitHooks
+        skipGitHooks,
+        autoCommit
     })
 
     const context = await resolveLocalDeploymentContext(rootDir)
@@ -53,17 +56,22 @@ export async function prepareLocalDeployment(config, {
             logSuccess,
             logWarning,
             lintCommand: checkSupport.lintCommand,
+            buildCommand: checkSupport.buildCommand,
             testCommand: checkSupport.testCommand
         })
 
-        await bumpLocalPackageVersion(rootDir, {
-            versionArg,
-            skipGitHooks,
-            runCommand,
-            logProcessing,
-            logSuccess,
-            logWarning
-        })
+        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,
@@ -90,6 +98,7 @@ export async function prepareLocalDeployment(config, {
         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 {
@@ -368,6 +369,8 @@ export async function runDeployment(config, options = {}) {
             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,
@@ -412,6 +415,7 @@ export async function runDeployment(config, options = {}) {
             rootDir,
             requiredPhpVersion,
             executionMode,
+            persistPresetOptions: presetState?.saveOptions,
             remoteIsLaravel: remoteState?.remoteIsLaravel,
             maintenanceModeEnabled: remoteState?.maintenanceModeEnabled,
             ssh,

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

@@ -66,16 +66,42 @@ export async function resolveLocalDeploymentCheckSupport({
         }
     }
 
+    const buildCommand = isLaravel && !skipTests
+        ? await preflight.resolveSupportedBuildCommand(rootDir, {commandExists})
+        : null
+
     const testCommand = isLaravel && !skipTests
         ? await resolveSupportedLaravelTestCommand(rootDir, {runCommandCapture})
         : null
 
     return {
         lintCommand,
+        buildCommand,
         testCommand
     }
 }
 
+async function runLocalLaravelBuild(rootDir, {runCommand, logProcessing, logSuccess, buildCommand} = {}) {
+    try {
+        await preflight.runBuild(rootDir, {
+            runCommand,
+            logProcessing,
+            logSuccess,
+            commandExists,
+            buildCommand
+        })
+    } catch (error) {
+        if (error.code === 'ENOENT') {
+            throw new Error(
+                'Failed to run local frontend build: npm executable not found.\n' +
+                'Make sure npm is installed and available in your PATH.'
+            )
+        }
+
+        throw new Error(`Local frontend build failed. Fix build failures before deploying.\n${error.message}`)
+    }
+}
+
 async function runLocalLaravelTests(rootDir, {runCommand, logProcessing, logSuccess, testCommand} = {}) {
     logProcessing?.('Running Laravel tests locally...')
 
@@ -108,10 +134,11 @@ export async function runLocalDeploymentChecks({
     logSuccess,
     logWarning,
     lintCommand = undefined,
+    buildCommand = undefined,
     testCommand = undefined
 } = {}) {
-    const support = lintCommand !== undefined || testCommand !== undefined
-        ? {lintCommand, testCommand}
+    const support = lintCommand !== undefined || buildCommand !== undefined || testCommand !== undefined
+        ? {lintCommand, buildCommand, testCommand}
         : await resolveLocalDeploymentCheckSupport({
             rootDir,
             isLaravel,
@@ -176,6 +203,15 @@ export async function runLocalDeploymentChecks({
     if (isLaravel && skipTests) {
         logWarning?.('Skipping tests because --skip-tests flag was provided.')
     } else if (isLaravel) {
+        if (support.buildCommand) {
+            await runLocalLaravelBuild(rootDir, {
+                runCommand,
+                logProcessing,
+                logSuccess,
+                buildCommand: support.buildCommand
+            })
+        }
+
         await runLocalLaravelTests(rootDir, {
             runCommand,
             logProcessing,