@wyxos/zephyr 0.4.2 → 0.4.4

package/README.md

@@ -87,6 +87,8 @@ 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.
+
 ## AI Agents and Automation
 
 Zephyr can be used safely by Codex, CI jobs, or other automation once configuration is already in place.

package/package.json

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

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

@@ -253,17 +253,17 @@ async function resolveMaintenanceMode({
         return snapshot.maintenanceModeEnabled
     }
 
-    if (executionMode?.interactive === false) {
-        if (typeof executionMode.maintenanceMode !== 'boolean') {
-            throw new ZephyrError(
-                'Zephyr cannot run this Laravel deployment non-interactively without an explicit maintenance-mode decision. Pass --maintenance on or --maintenance off.',
-                {code: 'ZEPHYR_MAINTENANCE_FLAG_REQUIRED'}
-            )
-        }
-
+    if (typeof executionMode.maintenanceMode === 'boolean') {
         return executionMode.maintenanceMode
     }
 
+    if (executionMode?.interactive === false) {
+        throw new ZephyrError(
+            'Zephyr cannot run this Laravel deployment non-interactively without an explicit maintenance-mode decision. Pass --maintenance on or --maintenance off.',
+            {code: 'ZEPHYR_MAINTENANCE_FLAG_REQUIRED'}
+        )
+    }
+
     if (typeof runPrompt !== 'function') {
         return false
     }

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

@@ -201,6 +201,7 @@ export async function runDeployment(config, options = {}) {
         logProcessing('Connection established. Acquiring deployment lock on server...')
         await acquireRemoteLock(ssh, remoteCwd, rootDir, {
             runPrompt,
+            logProcessing,
             logWarning,
             interactive: executionMode?.interactive !== false
         })
@@ -268,6 +269,7 @@ export async function runDeployment(config, options = {}) {
             try {
                 await compareLocksAndPrompt(rootDir, ssh, remoteCwd, {
                     runPrompt,
+                    logProcessing,
                     logWarning,
                     interactive: executionMode?.interactive !== false
                 })

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

@@ -105,14 +105,14 @@ export async function runLocalDeploymentChecks({
     if (hasHook) {
         if (skipGitHooks) {
             logWarning?.(
-                'Pre-push git hook detected. Built-in release checks are supported, and Zephyr will skip executing them here. WARNING: --skip-git-hooks is enabled, so Zephyr will also bypass that hook if it needs to push local commits during this release.'
+                'Pre-push git hook detected. Zephyr will run its built-in release checks manually because --skip-git-hooks is enabled, and the hook will be bypassed during git push.'
             )
         } else {
             logProcessing?.(
                 'Pre-push git hook detected. Built-in release checks are supported, but Zephyr will skip executing them here. If Zephyr pushes local commits during this release, the hook will run during git push.'
             )
+            return
         }
-        return
     }
 
     const lintRan = await preflight.runLinting(rootDir, {

package/src/cli/options.mjs

@@ -34,7 +34,7 @@ export function parseCliOptions(args = process.argv.slice(2)) {
         .option('--preset <name>', 'Preset name to use for non-interactive app deployments.')
         .option('--resume-pending', 'Resume a saved pending deployment snapshot without prompting.')
         .option('--discard-pending', 'Discard a saved pending deployment snapshot without prompting.')
-        .option('--maintenance <mode>', 'Laravel maintenance mode policy for non-interactive app deploys (on|off).')
+        .option('--maintenance <mode>', 'Laravel maintenance mode policy for app deployments (on|off).')
         .option('--skip-git-hooks', 'Bypass local git hooks for any commits and pushes Zephyr performs.')
         .option('--skip-tests', 'Skip test execution in package release workflows.')
         .option('--skip-lint', 'Skip lint execution in package release workflows.')

package/src/deploy/locks.mjs

@@ -14,6 +14,14 @@ function createLockPayload() {
   }
 }
 
+function createLockKey(details = {}) {
+  return `${details.user}@${details.hostname}:${details.pid}:${details.startedAt}`
+}
+
+function waitForDelay(delayMs) {
+  return new Promise((resolve) => setTimeout(resolve, delayMs))
+}
+
 export async function acquireLocalLock(rootDir) {
   const lockPath = getLockFilePath(rootDir)
   const configDir = getProjectConfigDir(rootDir)
@@ -68,12 +76,12 @@ export async function readRemoteLock(ssh, remoteCwd) {
   return null
 }
 
-function parseLockDetails(rawContent = '') {
-  try {
-    return JSON.parse(rawContent.trim())
-  } catch (_error) {
-    return { raw: rawContent.trim() }
-  }
+async function removeRemoteLock(ssh, remoteCwd) {
+  const lockPath = `.zephyr/${PROJECT_LOCK_FILE}`
+  const escapedLockPath = lockPath.replace(/'/g, "'\\''")
+  const removeCommand = `rm -f '${escapedLockPath}'`
+
+  await ssh.execCommand(removeCommand, { cwd: remoteCwd })
 }
 
 function formatLockHolder(details = {}) {
@@ -83,10 +91,80 @@ function formatLockHolder(details = {}) {
   return { startedBy, startedAt }
 }
 
+function buildRemoteLockConflictMessage(lockDetails, { stale = false } = {}) {
+  const { startedBy, startedAt } = formatLockHolder(lockDetails)
+
+  return stale
+    ? `Stale deployment lock detected on the server (started by ${startedBy}${startedAt}).`
+    : `Another deployment is currently in progress on the server (started by ${startedBy}${startedAt}).`
+}
+
+async function promptToResolveRemoteLockConflict(rootDir, ssh, remoteCwd, lockDetails, {
+  runPrompt,
+  logWarning,
+  logProcessing,
+  interactive = true,
+  stale = false,
+  wait = waitForDelay
+} = {}) {
+  const lockPath = `.zephyr/${PROJECT_LOCK_FILE}`
+
+  if (!interactive) {
+    if (stale) {
+      throw new ZephyrError(
+        `Stale deployment lock detected on the server (started by ${formatLockHolder(lockDetails).startedBy}${formatLockHolder(lockDetails).startedAt}). Remove ${remoteCwd}/${lockPath} manually before rerunning with --non-interactive.`,
+        {code: 'ZEPHYR_STALE_REMOTE_LOCK'}
+      )
+    }
+
+    const { startedBy, startedAt } = formatLockHolder(lockDetails)
+    throw new Error(
+      `Another deployment is currently in progress on the server (started by ${startedBy}${startedAt}). Remove ${remoteCwd}/${lockPath} if you are sure it is stale.`
+    )
+  }
+
+  if (typeof runPrompt !== 'function') {
+    throw new Error('Remote lock conflicts require runPrompt when Zephyr is interactive.')
+  }
+
+  let currentLock = lockDetails
+
+  while (currentLock) {
+    const { action } = await runPrompt([
+      {
+        type: 'list',
+        name: 'action',
+        message: `${buildRemoteLockConflictMessage(currentLock, { stale })} What would you like to do?`,
+        choices: [
+          {name: 'Delete the lock file and continue', value: 'delete'},
+          {name: 'Wait 60 seconds and check again', value: 'wait'}
+        ],
+        default: 'wait'
+      }
+    ])
+
+    if (action === 'delete') {
+      await removeRemoteLock(ssh, remoteCwd)
+      await releaseLocalLock(rootDir, { logWarning })
+      return
+    }
+
+    logProcessing?.('Waiting 60 seconds before checking the remote deployment lock again...')
+    await wait(60_000)
+
+    currentLock = await readRemoteLock(ssh, remoteCwd)
+    if (!currentLock) {
+      return
+    }
+  }
+}
+
 export async function compareLocksAndPrompt(rootDir, ssh, remoteCwd, {
   runPrompt,
   logWarning,
-  interactive = true
+  logProcessing,
+  interactive = true,
+  wait = waitForDelay
 } = {}) {
   const localLock = await readLocalLock(rootDir)
   const remoteLock = await readRemoteLock(ssh, remoteCwd)
@@ -95,36 +173,27 @@ export async function compareLocksAndPrompt(rootDir, ssh, remoteCwd, {
     return false
   }
 
-  const localKey = `${localLock.user}@${localLock.hostname}:${localLock.pid}:${localLock.startedAt}`
-  const remoteKey = `${remoteLock.user}@${remoteLock.hostname}:${remoteLock.pid}:${remoteLock.startedAt}`
+  const localKey = createLockKey(localLock)
+  const remoteKey = createLockKey(remoteLock)
 
   if (localKey === remoteKey) {
-    const { startedBy, startedAt } = formatLockHolder(remoteLock)
-
     if (!interactive) {
       throw new ZephyrError(
-        `Stale deployment lock detected on the server (started by ${startedBy}${startedAt}). Remove ${remoteCwd}/.zephyr/${PROJECT_LOCK_FILE} manually before rerunning with --non-interactive.`,
+        `Stale deployment lock detected on the server (started by ${formatLockHolder(remoteLock).startedBy}${formatLockHolder(remoteLock).startedAt}). Remove ${remoteCwd}/.zephyr/${PROJECT_LOCK_FILE} manually before rerunning with --non-interactive.`,
         {code: 'ZEPHYR_STALE_REMOTE_LOCK'}
       )
     }
 
-    const { shouldRemove } = await runPrompt([
-      {
-        type: 'confirm',
-        name: 'shouldRemove',
-        message: `Stale lock detected on server (started by ${startedBy}${startedAt}). This appears to be from a failed deployment. Remove it?`,
-        default: true
-      }
-    ])
+    await promptToResolveRemoteLockConflict(rootDir, ssh, remoteCwd, remoteLock, {
+      runPrompt,
+      logWarning,
+      logProcessing,
+      interactive,
+      stale: true,
+      wait
+    })
 
-    if (shouldRemove) {
-      const lockPath = `.zephyr/${PROJECT_LOCK_FILE}`
-      const escapedLockPath = lockPath.replace(/'/g, "'\\''")
-      const removeCommand = `rm -f '${escapedLockPath}'`
-      await ssh.execCommand(removeCommand, { cwd: remoteCwd })
-      await releaseLocalLock(rootDir, { logWarning })
-      return true
-    }
+    return true
   }
 
   return false
@@ -133,31 +202,70 @@ export async function compareLocksAndPrompt(rootDir, ssh, remoteCwd, {
 export async function acquireRemoteLock(ssh, remoteCwd, rootDir, {
   runPrompt,
   logWarning,
-  interactive = true
+  logProcessing,
+  interactive = true,
+  wait = waitForDelay
 } = {}) {
   const lockPath = `.zephyr/${PROJECT_LOCK_FILE}`
   const escapedLockPath = lockPath.replace(/'/g, "'\\''")
-  const checkCommand = `mkdir -p .zephyr && if [ -f '${escapedLockPath}' ]; then cat '${escapedLockPath}'; else echo "LOCK_NOT_FOUND"; fi`
-
-  const checkResult = await ssh.execCommand(checkCommand, { cwd: remoteCwd })
+  const remoteLock = await readRemoteLock(ssh, remoteCwd)
 
-  if (checkResult.stdout && checkResult.stdout.trim() !== 'LOCK_NOT_FOUND' && checkResult.stdout.trim() !== '') {
+  if (remoteLock) {
     const localLock = await readLocalLock(rootDir)
     if (localLock) {
-      const removed = await compareLocksAndPrompt(rootDir, ssh, remoteCwd, { runPrompt, logWarning, interactive })
-      if (!removed) {
-        const details = parseLockDetails(checkResult.stdout.trim())
-        const { startedBy, startedAt } = formatLockHolder(details)
+      const localKey = createLockKey(localLock)
+      const remoteKey = createLockKey(remoteLock)
+
+      if (localKey === remoteKey) {
+        const resolvedStaleLock = await compareLocksAndPrompt(rootDir, ssh, remoteCwd, {
+          runPrompt,
+          logWarning,
+          logProcessing,
+          interactive,
+          wait
+        })
+
+        if (!resolvedStaleLock) {
+          const refreshedRemoteLock = await readRemoteLock(ssh, remoteCwd)
+          if (refreshedRemoteLock) {
+            if (interactive) {
+              await promptToResolveRemoteLockConflict(rootDir, ssh, remoteCwd, refreshedRemoteLock, {
+                runPrompt,
+                logWarning,
+                logProcessing,
+                interactive,
+                wait
+              })
+            } else {
+              const { startedBy, startedAt } = formatLockHolder(refreshedRemoteLock)
+              throw new Error(
+                `Another deployment is currently in progress on the server (started by ${startedBy}${startedAt}). Remove ${remoteCwd}/${lockPath} if you are sure it is stale.`
+              )
+            }
+          }
+        }
+      } else if (interactive) {
+        await promptToResolveRemoteLockConflict(rootDir, ssh, remoteCwd, remoteLock, {
+          runPrompt,
+          logWarning,
+          logProcessing,
+          interactive,
+          wait
+        })
+      } else {
+        const { startedBy, startedAt } = formatLockHolder(remoteLock)
         throw new Error(
           `Another deployment is currently in progress on the server (started by ${startedBy}${startedAt}). Remove ${remoteCwd}/${lockPath} if you are sure it is stale.`
         )
       }
     } else {
-      const details = parseLockDetails(checkResult.stdout.trim())
-      const { startedBy, startedAt } = formatLockHolder(details)
-      throw new Error(
-        `Another deployment is currently in progress on the server (started by ${startedBy}${startedAt}). Remove ${remoteCwd}/${lockPath} if you are sure it is stale.`
-      )
+      await promptToResolveRemoteLockConflict(rootDir, ssh, remoteCwd, remoteLock, {
+        runPrompt,
+        logWarning,
+        logProcessing,
+        interactive,
+        wait
+      })
     }
   }