@wyxos/zephyr 0.7.5 → 0.8.0

package/README.md

@@ -49,6 +49,9 @@ zephyr minor --skip-checks
 # Deploy a configured app non-interactively
 zephyr --non-interactive --preset wyxos-release --maintenance off
 
+# Configure a Laravel app target and verify SSH without deploying
+zephyr --setup
+
 # Deploy a configured app non-interactively and auto-commit dirty changes
 zephyr --non-interactive --preset wyxos-release --auto-commit
 
@@ -106,6 +109,8 @@ then non-interactive mode stops immediately with a clear error instead.
 
 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.
 
+`--setup` is Laravel-only. It first verifies that the current project is a local Laravel app, then runs the normal local configuration prompts, tests SSH authentication to the selected server, and exits before local deploy preparation, pending snapshot handling, maintenance-mode decisions, locks, or remote deployment commands. On non-Laravel projects it fails before local setup changes are written.
+
 `--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`.

package/package.json

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

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

@@ -15,6 +15,7 @@ import {resolveRemotePath} from '../../utils/remote-path.mjs'
 import {buildRemoteDeploymentPlan, resolveRemoteDeploymentState} from './build-remote-deployment-plan.mjs'
 import {executeRemoteDeploymentPlan} from './execute-remote-deployment-plan.mjs'
 import {prepareLocalDeployment} from './prepare-local-deployment.mjs'
+import {verifyLaravelSetup} from './verify-laravel-setup.mjs'
 
 async function resolveRemoteHome(ssh, sshUser) {
     const remoteHomeResult = await ssh.execCommand('printf "%s" "$HOME"')
@@ -263,9 +264,22 @@ export async function runDeployment(config, options = {}) {
         executionMode
     } = context
 
+    const sshUser = config.sshUser || os.userInfo().username
+
+    if (executionMode?.setup === true) {
+        await verifyLaravelSetup({
+            config,
+            rootDir,
+            createSshClient,
+            sshUser,
+            logProcessing,
+            logSuccess
+        })
+        return
+    }
+
     await cleanupOldLogs(rootDir)
 
-    const sshUser = config.sshUser || os.userInfo().username
     const privateKeyPath = await resolveSshKeyPath(config.sshKey)
     const privateKey = await fs.readFile(privateKeyPath, 'utf8')
     let ssh = null

package/src/application/deploy/verify-laravel-setup.mjs

@@ -0,0 +1,43 @@
+import fs from 'node:fs/promises'
+
+import {isLocalLaravelProject} from '../../deploy/preflight.mjs'
+import {ZephyrError} from '../../runtime/errors.mjs'
+import {resolveSshKeyPath} from '../../ssh/keys.mjs'
+
+export async function assertLaravelSetupProject(rootDir) {
+    const isLaravel = await isLocalLaravelProject(rootDir)
+
+    if (!isLaravel) {
+        throw new ZephyrError(
+            'Zephyr setup is only supported for Laravel app projects.',
+            {code: 'ZEPHYR_SETUP_REQUIRES_LARAVEL'}
+        )
+    }
+}
+
+export async function verifyLaravelSetup({
+    config,
+    rootDir,
+    createSshClient,
+    sshUser,
+    logProcessing,
+    logSuccess
+} = {}) {
+    await assertLaravelSetupProject(rootDir)
+
+    const privateKeyPath = await resolveSshKeyPath(config.sshKey)
+    const privateKey = await fs.readFile(privateKeyPath, 'utf8')
+    const ssh = createSshClient()
+
+    try {
+        logProcessing?.(`\nConnecting to ${config.serverIp} as ${sshUser} to verify SSH setup...`)
+        await ssh.connect({
+            host: config.serverIp,
+            username: sshUser,
+            privateKey
+        })
+        logSuccess?.('Setup verified. SSH connection succeeded for this Laravel app.')
+    } finally {
+        ssh.dispose()
+    }
+}

package/src/cli/options.mjs

@@ -36,6 +36,7 @@ export function parseCliOptions(args = process.argv.slice(2)) {
         .option('--type <type>', 'Workflow type (node|vue|packagist). Omit for normal app deployments.')
         .option('--non-interactive', 'Fail instead of prompting when Zephyr needs user input.')
         .option('--json', 'Emit NDJSON events to stdout. Requires --non-interactive.')
+        .option('--setup', 'Configure an app deployment target and verify SSH connectivity without deploying.')
         .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.')
@@ -72,6 +73,7 @@ export function parseCliOptions(args = process.argv.slice(2)) {
         versionArg: program.args[0] ?? null,
         nonInteractive: Boolean(options.nonInteractive),
         json: Boolean(options.json),
+        setup: Boolean(options.setup),
         presetName: options.preset ?? null,
         resumePending: Boolean(options.resumePending),
         discardPending: Boolean(options.discardPending),
@@ -99,14 +101,19 @@ export function validateCliOptions(options = {}) {
         workflowType = null,
         nonInteractive = false,
         json = false,
+        setup = false,
         presetName = null,
         resumePending = false,
         discardPending = false,
         maintenanceMode = null,
         autoCommit = false,
         skipVersioning = false,
+        skipChecks = false,
+        skipTests = false,
+        skipLint = false,
         skipBuild = false,
-        skipDeploy = false
+        skipDeploy = false,
+        versionArg = null
     } = options
 
     if (json && !nonInteractive) {
@@ -120,6 +127,10 @@ export function validateCliOptions(options = {}) {
     const isPackageRelease = workflowType === 'node' || workflowType === 'vue' || workflowType === 'packagist'
 
     if (isPackageRelease) {
+        if (setup) {
+            throw new InvalidCliOptionsError('--setup is only valid for app deployments.')
+        }
+
         if (presetName) {
             throw new InvalidCliOptionsError('--preset is only valid for app deployments.')
         }
@@ -140,12 +151,34 @@ export function validateCliOptions(options = {}) {
             throw new InvalidCliOptionsError('--skip-build and --skip-deploy are only valid for node/vue release workflows.')
         }
 
+        if (setup) {
+            if (versionArg) {
+                throw new InvalidCliOptionsError('--setup cannot be used with a version or bump argument.')
+            }
+
+            if (resumePending || discardPending) {
+                throw new InvalidCliOptionsError('--setup cannot be used with pending deployment snapshot flags.')
+            }
+
+            if (maintenanceMode !== null) {
+                throw new InvalidCliOptionsError('--setup cannot be used with --maintenance.')
+            }
+
+            if (autoCommit) {
+                throw new InvalidCliOptionsError('--setup cannot be used with --auto-commit.')
+            }
+
+            if (skipVersioning || skipChecks || skipTests || skipLint) {
+                throw new InvalidCliOptionsError('--setup cannot be used with deployment skip flags.')
+            }
+        }
+
         if (nonInteractive && !presetName) {
             throw new InvalidCliOptionsError('--non-interactive app deployments require --preset <name>.')
         }
     }
 
-    if (skipVersioning && options.versionArg) {
+    if (skipVersioning && versionArg) {
         throw new InvalidCliOptionsError('--skip-versioning cannot be used together with an explicit version or bump argument.')
     }
 }

package/src/main.mjs

@@ -17,6 +17,7 @@ import {createConfigurationService} from './application/configuration/service.mj
 import {selectDeploymentTarget} from './application/configuration/select-deployment-target.mjs'
 import {resolvePendingSnapshot} from './application/deploy/resolve-pending-snapshot.mjs'
 import {runDeployment} from './application/deploy/run-deployment.mjs'
+import {assertLaravelSetupProject} from './application/deploy/verify-laravel-setup.mjs'
 import {SKIP_GIT_HOOKS_WARNING} from './utils/git-hooks.mjs'
 import {notifyWorkflowResult} from './utils/notifications.mjs'
 
@@ -32,6 +33,7 @@ function normalizeMainOptions(firstArg = null, secondArg = null) {
             versionArg: firstArg.versionArg ?? null,
             nonInteractive: firstArg.nonInteractive === true,
             json: firstArg.json === true,
+            setup: firstArg.setup === true,
             presetName: firstArg.presetName ?? null,
             resumePending: firstArg.resumePending === true,
             discardPending: firstArg.discardPending === true,
@@ -60,6 +62,7 @@ function normalizeMainOptions(firstArg = null, secondArg = null) {
         versionArg: secondArg ?? null,
         nonInteractive: false,
         json: false,
+        setup: false,
         presetName: null,
         resumePending: false,
         discardPending: false,
@@ -127,6 +130,7 @@ async function main(optionsOrWorkflowType = null, versionArg = null) {
         interactive: !options.nonInteractive,
         json: options.json === true && options.nonInteractive === true,
         workflow: resolveWorkflowName(options.workflowType),
+        setup: options.setup === true,
         presetName: options.presetName,
         maintenanceMode: options.maintenanceMode,
         autoCommit: options.autoCommit === true,
@@ -157,7 +161,8 @@ async function main(optionsOrWorkflowType = null, versionArg = null) {
     } = appContext
     let currentExecutionMode = {
         ...executionMode,
-        ...(appContext.executionMode ?? {})
+        ...(appContext.executionMode ?? {}),
+        setup: executionMode.setup === true || appContext.executionMode?.setup === true
     }
     appContext.executionMode = currentExecutionMode
     const configurationService = createConfigurationService(appContext)
@@ -171,6 +176,7 @@ async function main(optionsOrWorkflowType = null, versionArg = null) {
                 data: {
                     version: ZEPHYR_VERSION,
                     workflow: currentExecutionMode.workflow,
+                    setup: currentExecutionMode.setup === true,
                     nonInteractive: currentExecutionMode.interactive === false,
                     presetName: currentExecutionMode.presetName,
                     maintenanceMode: currentExecutionMode.maintenanceMode,
@@ -198,6 +204,10 @@ async function main(optionsOrWorkflowType = null, versionArg = null) {
             appContext
         })
 
+        if (currentExecutionMode.setup) {
+            await assertLaravelSetupProject(rootDir)
+        }
+
         if (options.workflowType === 'node' || options.workflowType === 'vue') {
             await releaseNode({
                 releaseType: options.versionArg,
@@ -277,7 +287,7 @@ async function main(optionsOrWorkflowType = null, versionArg = null) {
         const hasPackageJson = await fs.access(packageJsonPath).then(() => true).catch(() => false)
         const hasComposerJson = await fs.access(composerJsonPath).then(() => true).catch(() => false)
 
-        if (hasPackageJson || hasComposerJson) {
+        if (!currentExecutionMode.setup && (hasPackageJson || hasComposerJson)) {
             logProcessing('Validating dependencies...')
             await validateLocalDependencies(rootDir, runPrompt, logSuccess, {
                 interactive: currentExecutionMode.interactive,
@@ -292,7 +302,8 @@ async function main(optionsOrWorkflowType = null, versionArg = null) {
             logSuccess,
             logWarning,
             emitEvent,
-            executionMode: currentExecutionMode
+            executionMode: currentExecutionMode,
+            promptPresetOptions: currentExecutionMode.setup !== true
         })
 
         if (presetState) {
@@ -308,12 +319,14 @@ async function main(optionsOrWorkflowType = null, versionArg = null) {
             await presetState.applyExecutionMode(currentExecutionMode)
         }
 
-        const snapshotToUse = await resolvePendingSnapshot(rootDir, deploymentConfig, {
-            runPrompt,
-            logProcessing,
-            logWarning,
-            executionMode: currentExecutionMode
-        })
+        const snapshotToUse = currentExecutionMode.setup
+            ? null
+            : await resolvePendingSnapshot(rootDir, deploymentConfig, {
+                runPrompt,
+                logProcessing,
+                logWarning,
+                executionMode: currentExecutionMode
+            })
 
         await runRemoteTasks(deploymentConfig, {
             rootDir,

package/src/runtime/app-context.mjs

@@ -22,6 +22,7 @@ export function createAppContext({
         interactive: executionMode.interactive !== false,
         json: executionMode.json === true,
         workflow: executionMode.workflow ?? 'deploy',
+        setup: executionMode.setup === true,
         presetName: executionMode.presetName ?? null,
         maintenanceMode: executionMode.maintenanceMode ?? null,
         autoCommit: executionMode.autoCommit === true,