@wyxos/zephyr 0.4.1 → 0.4.3

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.1",
+  "version": "0.4.3",
   "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/bump-local-package-version.mjs

@@ -2,6 +2,7 @@ import fs from 'node:fs/promises'
 import path from 'node:path'
 
 import {commandExists} from '../../utils/command.mjs'
+import {gitCommitArgs} from '../../utils/git-hooks.mjs'
 
 async function readPackageJson(rootDir) {
     const packageJsonPath = path.join(rootDir, 'package.json')
@@ -20,6 +21,7 @@ async function isGitIgnored(rootDir, filePath, {runCommand} = {}) {
 
 export async function bumpLocalPackageVersion(rootDir, {
     versionArg = null,
+    skipGitHooks = false,
     runCommand,
     logProcessing,
     logSuccess,
@@ -72,7 +74,9 @@ export async function bumpLocalPackageVersion(rootDir, {
         return updatedPkg
     }
 
-    await runCommand('git', ['commit', '-m', `chore: bump version to ${nextVersion}`, '--', ...filesToStage], {
+    await runCommand('git', gitCommitArgs(['-m', `chore: bump version to ${nextVersion}`, '--', ...filesToStage], {
+        skipGitHooks
+    }), {
         cwd: rootDir
     })
     logSuccess?.(`Version updated to ${nextVersion}.`)

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

@@ -9,6 +9,7 @@ export async function prepareLocalDeployment(config, {
     snapshot = null,
     rootDir = process.cwd(),
     versionArg = null,
+    skipGitHooks = false,
     runPrompt,
     runCommand,
     runCommandCapture,
@@ -26,6 +27,7 @@ export async function prepareLocalDeployment(config, {
     if (!snapshot && context.isLaravel) {
         await bumpLocalPackageVersion(rootDir, {
             versionArg,
+            skipGitHooks,
             runCommand,
             logProcessing,
             logSuccess,
@@ -39,13 +41,15 @@ export async function prepareLocalDeployment(config, {
         runCommandCapture,
         logProcessing,
         logSuccess,
-        logWarning
+        logWarning,
+        skipGitHooks
     })
 
     await runLocalDeploymentChecks({
         rootDir,
         isLaravel: context.isLaravel,
         hasHook: context.hasHook,
+        skipGitHooks,
         runCommand,
         runCommandCapture,
         logProcessing,

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

@@ -179,6 +179,7 @@ export async function runDeployment(config, options = {}) {
             snapshot,
             rootDir,
             versionArg,
+            skipGitHooks: executionMode?.skipGitHooks === true,
             runPrompt,
             runCommand,
             runCommandCapture: context.runCommandCapture,

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

@@ -85,6 +85,7 @@ export async function runLocalDeploymentChecks({
     rootDir,
     isLaravel,
     hasHook,
+    skipGitHooks = false,
     runCommand,
     runCommandCapture,
     logProcessing,
@@ -102,9 +103,15 @@ export async function runLocalDeploymentChecks({
         })
 
     if (hasHook) {
-        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.'
-        )
+        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.'
+            )
+        } 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
     }
 
@@ -124,7 +131,8 @@ export async function runLocalDeploymentChecks({
                 getGitStatus: (dir) => getGitStatus(dir, {runCommandCapture}),
                 runCommand,
                 logProcessing,
-                logSuccess
+                logSuccess,
+                skipGitHooks
             })
         }
     }

package/src/application/release/release-node-package.mjs

@@ -11,6 +11,7 @@ import {
     runReleaseCommand,
     validateReleaseDependencies
 } from '../../release/shared.mjs'
+import {gitCommitArgs, gitPushArgs, npmVersionArgs} from '../../utils/git-hooks.mjs'
 
 async function readPackage(rootDir = process.cwd()) {
     const packagePath = join(rootDir, 'package.json')
@@ -137,7 +138,8 @@ async function runLibBuild(skipBuild, pkg, rootDir = process.cwd(), {
     logStep,
     logSuccess,
     logWarning,
-    runCommand = runReleaseCommand
+    runCommand = runReleaseCommand,
+    skipGitHooks = false
 } = {}) {
     if (skipBuild) {
         logWarning?.('Skipping library build because --skip-build flag was provided.')
@@ -173,7 +175,7 @@ async function runLibBuild(skipBuild, pkg, rootDir = process.cwd(), {
     if (hasLibChanges) {
         logStep?.('Committing lib build artifacts...')
         await runCommand('git', ['add', 'lib/'], {capture: true, cwd: rootDir})
-        await runCommand('git', ['commit', '-m', 'chore: build lib artifacts'], {capture: true, cwd: rootDir})
+        await runCommand('git', gitCommitArgs(['-m', 'chore: build lib artifacts'], {skipGitHooks}), {capture: true, cwd: rootDir})
         logSuccess?.('Lib build artifacts committed.')
     }
 
@@ -183,7 +185,8 @@ async function runLibBuild(skipBuild, pkg, rootDir = process.cwd(), {
 async function bumpVersion(releaseType, rootDir = process.cwd(), {
     logStep,
     logSuccess,
-    runCommand = runReleaseCommand
+    runCommand = runReleaseCommand,
+    skipGitHooks = false
 } = {}) {
     logStep?.('Bumping package version...')
 
@@ -199,7 +202,7 @@ async function bumpVersion(releaseType, rootDir = process.cwd(), {
     }
 
     try {
-        await runCommand('npm', ['version', releaseType], {capture: true, cwd: rootDir})
+        await runCommand('npm', npmVersionArgs(releaseType, {skipGitHooks}), {capture: true, cwd: rootDir})
     } finally {
         if (hasLibChanges) {
             logStep?.('Restoring lib build artifacts...')
@@ -207,14 +210,14 @@ async function bumpVersion(releaseType, rootDir = process.cwd(), {
             await runCommand('git', ['add', 'lib/'], {capture: true, cwd: rootDir})
             const {stdout: statusAfter} = await runCommand('git', ['status', '--porcelain'], {capture: true, cwd: rootDir})
             if (statusAfter.includes('lib/')) {
-                await runCommand('git', ['commit', '--amend', '--no-edit'], {capture: true, cwd: rootDir})
+                await runCommand('git', gitCommitArgs(['--amend', '--no-edit'], {skipGitHooks}), {capture: true, cwd: rootDir})
             }
         }
     }
 
     const pkg = await readPackage(rootDir)
     const commitMessage = `chore: release ${pkg.version}`
-    await runCommand('git', ['commit', '--amend', '-m', commitMessage], {capture: true, cwd: rootDir})
+    await runCommand('git', gitCommitArgs(['--amend', '-m', commitMessage], {skipGitHooks}), {capture: true, cwd: rootDir})
     await runCommand('git', ['tag', '-fa', `v${pkg.version}`, '-m', `v${pkg.version}`], {capture: true, cwd: rootDir})
 
     logSuccess?.(`Version updated to ${pkg.version}.`)
@@ -224,11 +227,12 @@ async function bumpVersion(releaseType, rootDir = process.cwd(), {
 async function pushChanges(rootDir = process.cwd(), {
     logStep,
     logSuccess,
-    runCommand = runReleaseCommand
+    runCommand = runReleaseCommand,
+    skipGitHooks = false
 } = {}) {
     logStep?.('Pushing commits and tags to origin...')
     try {
-        await runCommand('git', ['push', '--follow-tags'], {capture: true, cwd: rootDir})
+        await runCommand('git', gitPushArgs(['--follow-tags'], {skipGitHooks}), {capture: true, cwd: rootDir})
         logSuccess?.('Git push completed.')
     } catch (error) {
         if (error.stdout) {
@@ -256,7 +260,8 @@ async function deployGHPages(skipDeploy, pkg, rootDir = process.cwd(), {
     logStep,
     logSuccess,
     logWarning,
-    runCommand = runReleaseCommand
+    runCommand = runReleaseCommand,
+    skipGitHooks = false
 } = {}) {
     if (skipDeploy) {
         logWarning?.('Skipping GitHub Pages deployment because --skip-deploy flag was provided.')
@@ -324,8 +329,12 @@ async function deployGHPages(skipDeploy, pkg, rootDir = process.cwd(), {
         fs.cpSync(distPath, worktreeDir, {recursive: true})
 
         await runCommand('git', ['-C', worktreeDir, 'add', '-A'], {capture: true})
-        await runCommand('git', ['-C', worktreeDir, 'commit', '-m', `deploy: demo ${new Date().toISOString()}`, '--allow-empty'], {capture: true})
-        await runCommand('git', ['-C', worktreeDir, 'push', '-f', 'origin', 'gh-pages'], {capture: true})
+        await runCommand('git', [
+            '-C',
+            worktreeDir,
+            ...gitCommitArgs(['-m', `deploy: demo ${new Date().toISOString()}`, '--allow-empty'], {skipGitHooks})
+        ], {capture: true})
+        await runCommand('git', ['-C', worktreeDir, ...gitPushArgs(['-f', 'origin', 'gh-pages'], {skipGitHooks})], {capture: true})
 
         logSuccess?.('GitHub Pages deployment completed.')
     } catch (error) {
@@ -341,6 +350,7 @@ async function deployGHPages(skipDeploy, pkg, rootDir = process.cwd(), {
 
 export async function releaseNodePackage({
                                              releaseType,
+                                             skipGitHooks = false,
                                              skipTests = false,
                                              skipLint = false,
                                              skipBuild = false,
@@ -367,7 +377,8 @@ export async function releaseNodePackage({
     await validateReleaseDependencies(rootDir, {
         prompt: runPrompt,
         logSuccess,
-        interactive
+        interactive,
+        skipGitHooks
     })
 
     logStep?.('Checking working tree status...')
@@ -376,12 +387,12 @@ export async function releaseNodePackage({
 
     await runLint(skipLint, pkg, rootDir, {logStep, logSuccess, logWarning, runCommand})
     await runTests(skipTests, pkg, rootDir, {logStep, logSuccess, logWarning, runCommand})
-    await runLibBuild(skipBuild, pkg, rootDir, {logStep, logSuccess, logWarning, runCommand})
+    await runLibBuild(skipBuild, pkg, rootDir, {logStep, logSuccess, logWarning, runCommand, skipGitHooks})
 
-    const updatedPkg = await bumpVersion(releaseType, rootDir, {logStep, logSuccess, runCommand})
+    const updatedPkg = await bumpVersion(releaseType, rootDir, {logStep, logSuccess, runCommand, skipGitHooks})
     await runBuild(skipBuild, updatedPkg, rootDir, {logStep, logSuccess, logWarning, runCommand})
-    await pushChanges(rootDir, {logStep, logSuccess, runCommand})
-    await deployGHPages(skipDeploy, updatedPkg, rootDir, {logStep, logSuccess, logWarning, runCommand})
+    await pushChanges(rootDir, {logStep, logSuccess, runCommand, skipGitHooks})
+    await deployGHPages(skipDeploy, updatedPkg, rootDir, {logStep, logSuccess, logWarning, runCommand, skipGitHooks})
 
     logStep?.('Publishing will be handled by GitHub Actions via trusted publishing.')
     logSuccess?.(`Release workflow completed for ${updatedPkg.name}@${updatedPkg.version}.`)

package/src/application/release/release-packagist-package.mjs

@@ -11,6 +11,7 @@ import {
     runReleaseCommand,
     validateReleaseDependencies
 } from '../../release/shared.mjs'
+import {gitCommitArgs, gitPushArgs} from '../../utils/git-hooks.mjs'
 
 async function readComposer(rootDir = process.cwd()) {
     const composerPath = join(rootDir, 'composer.json')
@@ -162,7 +163,8 @@ async function runTests(skipTests, composer, rootDir = process.cwd(), {
 async function bumpVersion(releaseType, rootDir = process.cwd(), {
     logStep,
     logSuccess,
-    runCommand = runReleaseCommand
+    runCommand = runReleaseCommand,
+    skipGitHooks = false
 } = {}) {
     logStep?.('Bumping composer version...')
 
@@ -186,7 +188,7 @@ async function bumpVersion(releaseType, rootDir = process.cwd(), {
 
     const commitMessage = `chore: release ${newVersion}`
     logStep?.('Committing version bump...')
-    await runCommand('git', ['commit', '-m', commitMessage], {cwd: rootDir})
+    await runCommand('git', gitCommitArgs(['-m', commitMessage], {skipGitHooks}), {cwd: rootDir})
 
     logStep?.('Creating git tag...')
     await runCommand('git', ['tag', `v${newVersion}`], {cwd: rootDir})
@@ -198,19 +200,21 @@ async function bumpVersion(releaseType, rootDir = process.cwd(), {
 async function pushChanges(rootDir = process.cwd(), {
     logStep,
     logSuccess,
-    runCommand = runReleaseCommand
+    runCommand = runReleaseCommand,
+    skipGitHooks = false
 } = {}) {
     logStep?.('Pushing commits to origin...')
-    await runCommand('git', ['push'], {cwd: rootDir})
+    await runCommand('git', gitPushArgs([], {skipGitHooks}), {cwd: rootDir})
 
     logStep?.('Pushing tags to origin...')
-    await runCommand('git', ['push', 'origin', '--tags'], {cwd: rootDir})
+    await runCommand('git', gitPushArgs(['origin', '--tags'], {skipGitHooks}), {cwd: rootDir})
 
     logSuccess?.('Git push completed.')
 }
 
 export async function releasePackagistPackage({
                                                   releaseType,
+                                                  skipGitHooks = false,
                                                   skipTests = false,
                                                   skipLint = false,
                                                   rootDir = process.cwd(),
@@ -240,7 +244,8 @@ export async function releasePackagistPackage({
     await validateReleaseDependencies(rootDir, {
         prompt: runPrompt,
         logSuccess,
-        interactive
+        interactive,
+        skipGitHooks
     })
 
     logStep?.('Checking working tree status...')
@@ -250,8 +255,8 @@ export async function releasePackagistPackage({
     await runLint(skipLint, rootDir, {logStep, logSuccess, logWarning, runCommand, progressWriter})
     await runTests(skipTests, composer, rootDir, {logStep, logSuccess, logWarning, runCommand, progressWriter})
 
-    const updatedComposer = await bumpVersion(releaseType, rootDir, {logStep, logSuccess, runCommand})
-    await pushChanges(rootDir, {logStep, logSuccess, runCommand})
+    const updatedComposer = await bumpVersion(releaseType, rootDir, {logStep, logSuccess, runCommand, skipGitHooks})
+    await pushChanges(rootDir, {logStep, logSuccess, runCommand, skipGitHooks})
 
     logSuccess?.(`Release workflow completed for ${composer.name}@${updatedComposer.version}.`)
     logStep?.('Note: Packagist will automatically detect the new git tag and update the package.')

package/src/cli/options.mjs

@@ -34,7 +34,8 @@ 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.')
         .option('--skip-build', 'Skip build execution in node/vue release workflows.')
@@ -66,6 +67,7 @@ export function parseCliOptions(args = process.argv.slice(2)) {
         resumePending: Boolean(options.resumePending),
         discardPending: Boolean(options.discardPending),
         maintenanceMode: normalizeMaintenanceMode(options.maintenance),
+        skipGitHooks: Boolean(options.skipGitHooks),
         skipTests: Boolean(options.skipTests),
         skipLint: Boolean(options.skipLint),
         skipBuild: Boolean(options.skipBuild),

package/src/dependency-scanner.mjs

@@ -4,6 +4,7 @@ import process from 'node:process'
 import chalk from 'chalk'
 import {ZephyrError} from './runtime/errors.mjs'
 import { runCommand as runCommandBase, runCommandCapture as runCommandCaptureBase } from './utils/command.mjs'
+import {gitCommitArgs} from './utils/git-hooks.mjs'
 
 function isLocalPathOutsideRepo(depPath, rootDir) {
   if (!depPath || typeof depPath !== 'string') {
@@ -227,7 +228,9 @@ async function runCommand(command, args, { cwd = process.cwd(), capture = false
 }
 
 
-async function commitDependencyUpdates(rootDir, updatedFiles, promptFn, logFn) {
+async function commitDependencyUpdates(rootDir, updatedFiles, promptFn, logFn, {
+  skipGitHooks = false
+} = {}) {
   try {
     // Check if we're in a git repository
     await runCommand('git', ['rev-parse', '--is-inside-work-tree'], { capture: true, cwd: rootDir })
@@ -254,7 +257,7 @@ async function commitDependencyUpdates(rootDir, updatedFiles, promptFn, logFn) {
     logFn('Committing dependency updates...')
   }
 
-  await runCommand('git', ['commit', '-m', commitMessage, '--', ...updatedFiles], { cwd: rootDir })
+  await runCommand('git', gitCommitArgs(['-m', commitMessage, '--', ...updatedFiles], {skipGitHooks}), { cwd: rootDir })
 
   if (logFn) {
     logFn('Dependency updates committed.')
@@ -264,7 +267,8 @@ async function commitDependencyUpdates(rootDir, updatedFiles, promptFn, logFn) {
 }
 
 async function validateLocalDependencies(rootDir, promptFn, logFn = null, {
-  interactive = true
+  interactive = true,
+  skipGitHooks = false
 } = {}) {
   const packageDeps = await scanPackageJsonDependencies(rootDir)
   const composerDeps = await scanComposerJsonDependencies(rootDir)
@@ -401,7 +405,9 @@ async function validateLocalDependencies(rootDir, promptFn, logFn = null, {
 
   // Commit the changes if any files were updated
   if (updatedFiles.size > 0) {
-    const committed = await commitDependencyUpdates(rootDir, Array.from(updatedFiles), promptFn, logFn)
+    const committed = await commitDependencyUpdates(rootDir, Array.from(updatedFiles), promptFn, logFn, {
+      skipGitHooks
+    })
     if (!committed) {
       throw new Error(
         'Release cancelled: dependency updates were applied but were not committed. Commit/stash your changes and rerun.'

package/src/deploy/local-repo.mjs

@@ -1,5 +1,6 @@
 import { getCurrentBranch as getCurrentBranchImpl, getUpstreamRef as getUpstreamRefImpl } from '../utils/git.mjs'
 import {hasPrePushHook} from './preflight.mjs'
+import {gitCommitArgs, gitPushArgs} from '../utils/git-hooks.mjs'
 
 export async function getCurrentBranch(rootDir) {
   const branch = await getCurrentBranchImpl(rootDir)
@@ -165,7 +166,9 @@ async function commitAndPushStagedChanges(targetBranch, rootDir, {
   runCommand,
   getGitStatus,
   logProcessing,
-  logSuccess
+  logSuccess,
+  logWarning,
+  skipGitHooks = false
 } = {}) {
   const { commitMessage } = await runPrompt([
     {
@@ -179,15 +182,19 @@ async function commitAndPushStagedChanges(targetBranch, rootDir, {
   const message = commitMessage.trim()
 
   logProcessing?.('Committing staged changes before deployment...')
-  await runCommand('git', ['commit', '-m', message], { cwd: rootDir })
+  await runCommand('git', gitCommitArgs(['-m', message], {skipGitHooks}), { cwd: rootDir })
 
   const prePushHookPresent = await hasPrePushHook(rootDir)
   if (prePushHookPresent) {
-    logProcessing?.('Pre-push git hook detected. Running hook during git push...')
+    if (skipGitHooks) {
+      logWarning?.('Pre-push git hook detected, but Zephyr will bypass it because --skip-git-hooks was provided.')
+    } else {
+      logProcessing?.('Pre-push git hook detected. Running hook during git push...')
+    }
   }
 
   try {
-    await runCommand('git', ['push', 'origin', targetBranch], { cwd: rootDir })
+    await runCommand('git', gitPushArgs(['origin', targetBranch], {skipGitHooks}), { cwd: rootDir })
   } catch (error) {
     if (prePushHookPresent) {
       throw new Error(`Git push failed while the pre-push hook was running. See hook output above.\n${error.message}`)
@@ -211,6 +218,7 @@ export async function ensureCommittedChangesPushed(targetBranch, rootDir, {
   logProcessing,
   logSuccess,
   logWarning,
+  skipGitHooks = false,
   getUpstreamRef: getUpstreamRefFn = getUpstreamRef,
   readUpstreamSyncState: readUpstreamSyncStateFn = (branch, dir) =>
     readUpstreamSyncState(branch, dir, {
@@ -256,11 +264,15 @@ export async function ensureCommittedChangesPushed(targetBranch, rootDir, {
   const prePushHookPresent = await hasPrePushHookFn(rootDir)
 
   if (prePushHookPresent) {
-    logProcessing?.('Pre-push git hook detected. Running hook during git push...')
+    if (skipGitHooks) {
+      logWarning?.('Pre-push git hook detected, but Zephyr will bypass it because --skip-git-hooks was provided.')
+    } else {
+      logProcessing?.('Pre-push git hook detected. Running hook during git push...')
+    }
   }
 
   try {
-    await runCommandCapture('git', ['push', remoteName, `${targetBranch}:${upstreamBranch}`], { cwd: rootDir })
+    await runCommandCapture('git', gitPushArgs([remoteName, `${targetBranch}:${upstreamBranch}`], {skipGitHooks}), { cwd: rootDir })
   } catch (error) {
     if (prePushHookPresent) {
       const hookOutput = [error.stdout, error.stderr]
@@ -290,6 +302,7 @@ export async function ensureLocalRepositoryState(targetBranch, rootDir = process
   logProcessing,
   logSuccess,
   logWarning,
+  skipGitHooks = false,
   getCurrentBranch: getCurrentBranchFn = getCurrentBranch,
   getGitStatus: getGitStatusFn = (dir) => getGitStatus(dir, { runCommandCapture }),
   readUpstreamSyncState: readUpstreamSyncStateFn = (branch, dir) =>
@@ -304,7 +317,8 @@ export async function ensureLocalRepositoryState(targetBranch, rootDir = process
       runCommandCapture,
       logProcessing,
       logSuccess,
-      logWarning
+      logWarning,
+      skipGitHooks
     })
 } = {}) {
   if (!targetBranch) {
@@ -369,7 +383,9 @@ export async function ensureLocalRepositoryState(targetBranch, rootDir = process
     runCommand,
     getGitStatus: getGitStatusFn,
     logProcessing,
-    logSuccess
+    logSuccess,
+    logWarning,
+    skipGitHooks
   })
 
   await ensureCommittedChangesPushedFn(targetBranch, rootDir)

package/src/deploy/preflight.mjs

@@ -1,6 +1,8 @@
 import fs from 'node:fs/promises'
 import path from 'node:path'
 
+import {gitCommitArgs} from '../utils/git-hooks.mjs'
+
 export async function hasPrePushHook(rootDir) {
   const hookPaths = [
     path.join(rootDir, '.git', 'hooks', 'pre-push'),
@@ -126,7 +128,13 @@ export function hasStagedChanges(statusOutput) {
   })
 }
 
-export async function commitLintingChanges(rootDir, { getGitStatus, runCommand, logProcessing, logSuccess } = {}) {
+export async function commitLintingChanges(rootDir, {
+  getGitStatus,
+  runCommand,
+  logProcessing,
+  logSuccess,
+  skipGitHooks = false
+} = {}) {
   const status = await getGitStatus(rootDir)
 
   if (!hasStagedChanges(status)) {
@@ -138,7 +146,7 @@ export async function commitLintingChanges(rootDir, { getGitStatus, runCommand,
   }
 
   logProcessing?.('Committing linting changes...')
-  await runCommand('git', ['commit', '-m', 'style: apply linting fixes'], { cwd: rootDir })
+  await runCommand('git', gitCommitArgs(['-m', 'style: apply linting fixes'], {skipGitHooks}), { cwd: rootDir })
   logSuccess?.('Linting changes committed.')
   return true
 }

package/src/main.mjs

@@ -16,6 +16,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 {SKIP_GIT_HOOKS_WARNING} from './utils/git-hooks.mjs'
 
 const RELEASE_SCRIPT_NAME = 'release'
 const RELEASE_SCRIPT_COMMAND = 'npx @wyxos/zephyr@latest'
@@ -33,6 +34,7 @@ function normalizeMainOptions(firstArg = null, secondArg = null) {
             resumePending: firstArg.resumePending === true,
             discardPending: firstArg.discardPending === true,
             maintenanceMode: firstArg.maintenanceMode ?? null,
+            skipGitHooks: firstArg.skipGitHooks === true,
             skipTests: firstArg.skipTests === true,
             skipLint: firstArg.skipLint === true,
             skipBuild: firstArg.skipBuild === true,
@@ -50,6 +52,7 @@ function normalizeMainOptions(firstArg = null, secondArg = null) {
         resumePending: false,
         discardPending: false,
         maintenanceMode: null,
+        skipGitHooks: false,
         skipTests: false,
         skipLint: false,
         skipBuild: false,
@@ -86,6 +89,7 @@ async function main(optionsOrWorkflowType = null, versionArg = null) {
         workflow: resolveWorkflowName(options.workflowType),
         presetName: options.presetName,
         maintenanceMode: options.maintenanceMode,
+        skipGitHooks: options.skipGitHooks === true,
         resumePending: options.resumePending,
         discardPending: options.discardPending
     }
@@ -114,6 +118,7 @@ async function main(optionsOrWorkflowType = null, versionArg = null) {
                     nonInteractive: currentExecutionMode.interactive === false,
                     presetName: currentExecutionMode.presetName,
                     maintenanceMode: currentExecutionMode.maintenanceMode,
+                    skipGitHooks: currentExecutionMode.skipGitHooks === true,
                     resumePending: currentExecutionMode.resumePending,
                     discardPending: currentExecutionMode.discardPending
                 }
@@ -122,9 +127,14 @@ async function main(optionsOrWorkflowType = null, versionArg = null) {
             logProcessing(`Zephyr v${ZEPHYR_VERSION}`)
         }
 
+        if (currentExecutionMode.skipGitHooks) {
+            logWarning(SKIP_GIT_HOOKS_WARNING)
+        }
+
         if (options.workflowType === 'node' || options.workflowType === 'vue') {
             await releaseNode({
                 releaseType: options.versionArg,
+                skipGitHooks: options.skipGitHooks,
                 skipTests: options.skipTests,
                 skipLint: options.skipLint,
                 skipBuild: options.skipBuild,
@@ -144,6 +154,7 @@ async function main(optionsOrWorkflowType = null, versionArg = null) {
         if (options.workflowType === 'packagist') {
             await releasePackagist({
                 releaseType: options.versionArg,
+                skipGitHooks: options.skipGitHooks,
                 skipTests: options.skipTests,
                 skipLint: options.skipLint,
                 context: appContext
@@ -164,13 +175,15 @@ async function main(optionsOrWorkflowType = null, versionArg = null) {
             projectConfigDir: PROJECT_CONFIG_DIR,
             runCommand,
             logSuccess,
-            logWarning
+            logWarning,
+            skipGitHooks: currentExecutionMode.skipGitHooks
         })
         await bootstrap.ensureProjectReleaseScript(rootDir, {
             runPrompt,
             runCommand,
             logSuccess,
             logWarning,
+            skipGitHooks: currentExecutionMode.skipGitHooks,
             interactive: currentExecutionMode.interactive,
             releaseScriptName: RELEASE_SCRIPT_NAME,
             releaseScriptCommand: RELEASE_SCRIPT_COMMAND
@@ -184,7 +197,8 @@ async function main(optionsOrWorkflowType = null, versionArg = null) {
         if (hasPackageJson || hasComposerJson) {
             logProcessing('Validating dependencies...')
             await validateLocalDependencies(rootDir, runPrompt, logSuccess, {
-                interactive: currentExecutionMode.interactive
+                interactive: currentExecutionMode.interactive,
+                skipGitHooks: currentExecutionMode.skipGitHooks
             })
         }
 

package/src/project/bootstrap.mjs

@@ -2,12 +2,14 @@ import fs from 'node:fs/promises'
 import path from 'node:path'
 
 import {ZephyrError} from '../runtime/errors.mjs'
+import {gitCommitArgs} from '../utils/git-hooks.mjs'
 
 export async function ensureGitignoreEntry(rootDir, {
   projectConfigDir = '.zephyr',
   runCommand,
   logSuccess,
-  logWarning
+  logWarning,
+  skipGitHooks = false
 } = {}) {
   const gitignorePath = path.join(rootDir, '.gitignore')
   const targetEntry = `${projectConfigDir}/`
@@ -53,7 +55,7 @@ export async function ensureGitignoreEntry(rootDir, {
 
   try {
     await runCommand('git', ['add', '.gitignore'], { cwd: rootDir })
-    await runCommand('git', ['commit', '-m', 'chore: ignore zephyr config'], { cwd: rootDir })
+    await runCommand('git', gitCommitArgs(['-m', 'chore: ignore zephyr config'], {skipGitHooks}), { cwd: rootDir })
   } catch (error) {
     if (error.exitCode === 1) {
       logWarning?.('Git commit skipped: nothing to commit or pre-commit hook prevented commit.')
@@ -68,6 +70,7 @@ export async function ensureProjectReleaseScript(rootDir, {
   runCommand,
   logSuccess,
   logWarning,
+  skipGitHooks = false,
   interactive = true,
   releaseScriptName = 'release',
   releaseScriptCommand = 'npx @wyxos/zephyr@latest'
@@ -141,7 +144,7 @@ export async function ensureProjectReleaseScript(rootDir, {
   if (isGitRepo) {
     try {
       await runCommand('git', ['add', 'package.json'], { cwd: rootDir, silent: true })
-      await runCommand('git', ['commit', '-m', 'chore: add zephyr release script'], { cwd: rootDir, silent: true })
+      await runCommand('git', gitCommitArgs(['-m', 'chore: add zephyr release script'], {skipGitHooks}), { cwd: rootDir, silent: true })
       logSuccess?.('Committed package.json release script addition.')
     } catch (error) {
       if (error.exitCode === 1) {

package/src/release/shared.mjs

@@ -101,9 +101,13 @@ export async function ensureCleanWorkingTree(rootDir = process.cwd(), {
 export async function validateReleaseDependencies(rootDir = process.cwd(), {
   prompt = (questions) => inquirer.prompt(questions),
   logSuccess,
-  interactive = true
+  interactive = true,
+  skipGitHooks = false
 } = {}) {
-  await validateLocalDependencies(rootDir, prompt, logSuccess, { interactive })
+  await validateLocalDependencies(rootDir, prompt, logSuccess, {
+    interactive,
+    skipGitHooks
+  })
 }
 
 export async function ensureReleaseBranchReady({

package/src/release-node.mjs

@@ -3,11 +3,29 @@ import {createAppContext} from './runtime/app-context.mjs'
 import {parseReleaseArgs} from './release/shared.mjs'
 import {releaseNodePackage} from './application/release/release-node-package.mjs'
 
+function hasExplicitReleaseOptions(options = {}) {
+    return [
+        'releaseType',
+        'skipGitHooks',
+        'skipTests',
+        'skipLint',
+        'skipBuild',
+        'skipDeploy'
+    ].some((key) => key in options)
+}
+
 export async function releaseNode(options = {}) {
-    const parsed = options.releaseType
-        ? options
+    const parsed = hasExplicitReleaseOptions(options)
+        ? {
+            releaseType: options.releaseType ?? 'patch',
+            skipGitHooks: options.skipGitHooks === true,
+            skipTests: options.skipTests === true,
+            skipLint: options.skipLint === true,
+            skipBuild: options.skipBuild === true,
+            skipDeploy: options.skipDeploy === true
+        }
         : parseReleaseArgs({
-            booleanFlags: ['--skip-tests', '--skip-lint', '--skip-build', '--skip-deploy']
+            booleanFlags: ['--skip-git-hooks', '--skip-tests', '--skip-lint', '--skip-build', '--skip-deploy']
         })
     const rootDir = options.rootDir ?? process.cwd()
     const context = options.context ?? createAppContext({
@@ -21,6 +39,7 @@ export async function releaseNode(options = {}) {
 
     await releaseNodePackage({
         releaseType: parsed.releaseType,
+        skipGitHooks: parsed.skipGitHooks === true || executionMode?.skipGitHooks === true,
         skipTests: parsed.skipTests === true,
         skipLint: parsed.skipLint === true,
         skipBuild: parsed.skipBuild === true,

package/src/release-packagist.mjs

@@ -3,11 +3,25 @@ import {createAppContext} from './runtime/app-context.mjs'
 import {parseReleaseArgs} from './release/shared.mjs'
 import {releasePackagistPackage} from './application/release/release-packagist-package.mjs'
 
+function hasExplicitReleaseOptions(options = {}) {
+    return [
+        'releaseType',
+        'skipGitHooks',
+        'skipTests',
+        'skipLint'
+    ].some((key) => key in options)
+}
+
 export async function releasePackagist(options = {}) {
-    const parsed = options.releaseType
-        ? options
+    const parsed = hasExplicitReleaseOptions(options)
+        ? {
+            releaseType: options.releaseType ?? 'patch',
+            skipGitHooks: options.skipGitHooks === true,
+            skipTests: options.skipTests === true,
+            skipLint: options.skipLint === true
+        }
         : parseReleaseArgs({
-            booleanFlags: ['--skip-tests', '--skip-lint']
+            booleanFlags: ['--skip-git-hooks', '--skip-tests', '--skip-lint']
         })
     const rootDir = options.rootDir ?? process.cwd()
     const context = options.context ?? createAppContext({
@@ -21,6 +35,7 @@ export async function releasePackagist(options = {}) {
 
     await releasePackagistPackage({
         releaseType: parsed.releaseType,
+        skipGitHooks: parsed.skipGitHooks === true || executionMode?.skipGitHooks === true,
         skipTests: parsed.skipTests === true,
         skipLint: parsed.skipLint === true,
         rootDir,

package/src/runtime/app-context.mjs

@@ -22,6 +22,7 @@ export function createAppContext({
         workflow: executionMode.workflow ?? 'deploy',
         presetName: executionMode.presetName ?? null,
         maintenanceMode: executionMode.maintenanceMode ?? null,
+        skipGitHooks: executionMode.skipGitHooks === true,
         resumePending: executionMode.resumePending === true,
         discardPending: executionMode.discardPending === true
     }

package/src/utils/git-hooks.mjs

@@ -0,0 +1,26 @@
+export const SKIP_GIT_HOOKS_WARNING =
+    'WARNING: --skip-git-hooks is enabled. Zephyr will bypass local git hooks for any commits and pushes it performs during this run.'
+
+export function gitCommitArgs(args = [], {skipGitHooks = false} = {}) {
+    return skipGitHooks
+        ? ['commit', '--no-verify', ...args]
+        : ['commit', ...args]
+}
+
+export function gitPushArgs(args = [], {skipGitHooks = false} = {}) {
+    return skipGitHooks
+        ? ['push', '--no-verify', ...args]
+        : ['push', ...args]
+}
+
+export function npmVersionArgs(releaseType, {
+    skipGitHooks = false,
+    extraArgs = []
+} = {}) {
+    return [
+        'version',
+        releaseType,
+        ...(skipGitHooks ? ['--no-commit-hooks'] : []),
+        ...extraArgs
+    ]
+}