@wyxos/zephyr 0.8.3 → 0.9.0

package/README.md

@@ -40,7 +40,10 @@ Common workflows:
 # Deploy an app using the saved preset or the interactive prompts
 zephyr
 
-# Deploy an app with a local npm package version bump
+# Deploy an app with Zephyr's recommended local npm package version bump
+zephyr
+
+# Deploy an app with an explicit local npm package version bump
 zephyr minor
 
 # Deploy an app while bypassing Zephyr's built-in local checks
@@ -64,7 +67,7 @@ zephyr --non-interactive --preset wyxos-release --resume-pending --maintenance o
 # Emit NDJSON events for automation or agent tooling
 zephyr --non-interactive --json --preset wyxos-release --maintenance on
 
-# Release a Node/Vue package (defaults to a patch bump)
+# Release a Node/Vue package with Zephyr's recommended bump
 zephyr --type node
 
 # Release a Node/Vue package with an explicit bump
@@ -81,7 +84,7 @@ 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`.
+When an app deployment or a `--type node`/`--type vue` package release omits the bump argument, Zephyr recommends a version bump from changes since the last release reference, using Codex when available and deterministic heuristics as a fallback.
 
 ## Interactive and Non-Interactive Modes
 

package/package.json

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

package/src/application/deploy/bump-local-package-version.mjs

@@ -3,6 +3,7 @@ import path from 'node:path'
 
 import {commandExists} from '../../utils/command.mjs'
 import {gitCommitArgs} from '../../utils/git-hooks.mjs'
+import {resolveReleaseType} from '../../release/release-type.mjs'
 
 async function readPackageJson(rootDir) {
     const packageJsonPath = path.join(rootDir, 'package.json')
@@ -19,8 +20,63 @@ async function isGitIgnored(rootDir, filePath, {runCommand} = {}) {
     }
 }
 
+async function readLatestVersionBumpCommit(rootDir, {runCommand} = {}) {
+    if (typeof runCommand !== 'function') {
+        return null
+    }
+
+    try {
+        const {stdout = ''} = await runCommand('git', ['log', '--format=%H%x00%h%x00%s', '-50'], {
+            capture: true,
+            cwd: rootDir
+        })
+
+        for (const line of stdout.split('\n')) {
+            const [hash, shortHash, subject] = line.split('\0')
+            if (/^chore: bump version to \d+\.\d+\.\d+(?:[-+].*)?$/i.test(subject ?? '')) {
+                return {hash, shortHash}
+            }
+        }
+    } catch {
+        return null
+    }
+
+    return null
+}
+
+async function resolveDeploymentVersionValue(rootDir, {
+    versionArg = null,
+    pkg,
+    interactive = false,
+    runPrompt,
+    runCommand,
+    logProcessing,
+    logWarning
+} = {}) {
+    if (versionArg && String(versionArg).trim().length > 0) {
+        return String(versionArg).trim()
+    }
+
+    const latestVersionBump = await readLatestVersionBumpCommit(rootDir, {runCommand})
+
+    return await resolveReleaseType({
+        currentVersion: pkg.version,
+        packageName: pkg.name ?? 'this app',
+        rootDir,
+        interactive,
+        runPrompt,
+        runCommand,
+        logStep: logProcessing,
+        logWarning,
+        latestTag: latestVersionBump?.hash ?? null,
+        referenceLabel: latestVersionBump ? `last app version bump ${latestVersionBump.shortHash}` : null
+    })
+}
+
 export async function bumpLocalPackageVersion(rootDir, {
     versionArg = null,
+    interactive = false,
+    runPrompt,
     skipGitHooks = false,
     runCommand,
     logProcessing,
@@ -43,9 +99,15 @@ export async function bumpLocalPackageVersion(rootDir, {
         return null
     }
 
-    const releaseValue = (versionArg && String(versionArg).trim().length > 0)
-        ? String(versionArg).trim()
-        : 'patch'
+    const releaseValue = await resolveDeploymentVersionValue(rootDir, {
+        versionArg,
+        pkg,
+        interactive,
+        runPrompt,
+        runCommand,
+        logProcessing,
+        logWarning
+    })
 
     logProcessing?.(`Bumping npm package version (${releaseValue})...`)
     await runCommand('npm', ['version', releaseValue, '--no-git-tag-version', '--force'], {cwd: rootDir})

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

@@ -14,6 +14,7 @@ export async function prepareLocalDeployment(config, {
     skipLint = false,
     skipVersioning = false,
     autoCommit = false,
+    interactive = true,
     runPrompt,
     runCommand,
     runCommandCapture,
@@ -66,6 +67,8 @@ export async function prepareLocalDeployment(config, {
             await bumpLocalPackageVersion(rootDir, {
                 versionArg,
                 skipGitHooks,
+                interactive,
+                runPrompt,
                 runCommand,
                 logProcessing,
                 logSuccess,

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

@@ -385,6 +385,7 @@ export async function runDeployment(config, options = {}) {
             skipLint: executionMode?.skipLint === true,
             skipVersioning: executionMode?.skipVersioning === true,
             autoCommit: executionMode?.autoCommit === true,
+            interactive: executionMode?.interactive !== false,
             runPrompt,
             runCommand,
             runCommandCapture: context.runCommandCapture,

package/src/release/commit-message.mjs

@@ -161,6 +161,17 @@ export function suggestFallbackCommitMessage(statusEntries = []) {
     return null
   }
 
+  const hasTests = paths.some((entryPath) => (
+    entryPath.startsWith('tests/')
+    || entryPath.includes('.test.')
+    || entryPath.includes('.spec.')
+  ))
+  const hasApplicationCode = paths.some((entryPath) => (
+    ['app/', 'bootstrap/', 'config/', 'database/', 'extension/', 'resources/', 'routes/'].some((prefix) => entryPath.startsWith(prefix))
+    || entryPath.startsWith('artisan')
+    || entryPath.startsWith('vite.config.')
+  ))
+
   if (paths.some((entryPath) => entryPath.includes('FullscreenPreviewRail'))) {
     return 'feat: refine fullscreen preview rail'
   }
@@ -174,7 +185,7 @@ export function suggestFallbackCommitMessage(statusEntries = []) {
   }
 
   if (paths.some((entryPath) => entryPath.startsWith('src/'))) {
-    return paths.some((entryPath) => entryPath.startsWith('tests/') || entryPath.includes('.test.'))
+    return hasTests
       ? 'fix: update source behavior and tests'
       : 'fix: update source behavior'
   }
@@ -183,9 +194,20 @@ export function suggestFallbackCommitMessage(statusEntries = []) {
     return 'chore: update package metadata'
   }
 
-  return null
+  if (hasApplicationCode) {
+    return hasTests
+      ? 'fix: update application behavior and tests'
+      : 'fix: update application behavior'
+  }
+
+  if (hasTests) {
+    return 'test: update test coverage'
+  }
+
+  return 'chore: update project files'
 }
 
+
 export async function suggestCommitMessage(rootDir = process.cwd(), {
   runCommand,
   commandExistsImpl = commandExists,

package/src/release/release-type.mjs

@@ -87,7 +87,11 @@ function buildChoiceOrder(suggestedReleaseType) {
   ]
 }
 
-async function readLatestReleaseTag(rootDir, {runCommand} = {}) {
+async function readLatestReleaseTag(rootDir, {runCommand, latestTag = null} = {}) {
+  if (typeof latestTag === 'string' && latestTag.trim() !== '') {
+    return latestTag.trim()
+  }
+
   try {
     const {stdout} = await runCommand('git', ['describe', '--tags', '--abbrev=0'], {
       capture: true,
@@ -137,16 +141,19 @@ async function readDiffStat(rootDir, {runCommand, latestTag} = {}) {
 async function buildReleaseSuggestionContext(rootDir, {
   runCommand,
   currentVersion,
-  packageName
+  packageName,
+  latestTag = null,
+  referenceLabel = null
 } = {}) {
-  const latestTag = await readLatestReleaseTag(rootDir, {runCommand})
-  const commitLog = await readCommitLog(rootDir, {runCommand, latestTag})
-  const diffStat = await readDiffStat(rootDir, {runCommand, latestTag})
+  const resolvedLatestTag = await readLatestReleaseTag(rootDir, {runCommand, latestTag})
+  const commitLog = await readCommitLog(rootDir, {runCommand, latestTag: resolvedLatestTag})
+  const diffStat = await readDiffStat(rootDir, {runCommand, latestTag: resolvedLatestTag})
 
   return {
     currentVersion,
     packageName,
-    latestTag,
+    latestTag: resolvedLatestTag,
+    referenceLabel: referenceLabel ?? resolvedLatestTag,
     commitLog,
     diffStat
   }
@@ -158,12 +165,16 @@ async function suggestReleaseType(rootDir = process.cwd(), {
   packageName,
   commandExistsImpl = commandExists,
   logStep,
-  logWarning
+  logWarning,
+  latestTag = null,
+  referenceLabel = null
 } = {}) {
   const context = await buildReleaseSuggestionContext(rootDir, {
     runCommand,
     currentVersion,
-    packageName
+    packageName,
+    latestTag,
+    referenceLabel
   })
   const allowedSuggestedReleaseTypes = resolveSuggestedReleaseTypeOptions(currentVersion)
   const heuristicReleaseType = inferReleaseTypeHeuristically(context)
@@ -201,7 +212,7 @@ async function suggestReleaseType(rootDir = process.cwd(), {
         'Prefer stable release types unless the current version already has a prerelease identifier.',
         `Package: ${packageName || 'unknown package'}`,
         `Current version: ${currentVersion || 'unknown'}`,
-        `Latest release tag: ${context.latestTag || 'none found'}`,
+        `Latest release reference: ${context.referenceLabel || context.latestTag || 'none found'}`,
         'Commits since the last release:',
         context.commitLog || '- no commits found',
         'Diff summary since the last release:',
@@ -252,7 +263,9 @@ export async function resolveReleaseType({
   runPrompt,
   runCommand,
   logStep,
-  logWarning
+  logWarning,
+  latestTag = null,
+  referenceLabel = null
 } = {}) {
   if (releaseType) {
     return releaseType
@@ -263,10 +276,12 @@ export async function resolveReleaseType({
     currentVersion,
     packageName,
     logStep,
-    logWarning
+    logWarning,
+    latestTag,
+    referenceLabel
   })
-  const rangeLabel = suggested.latestTag
-    ? `based on changes since ${suggested.latestTag}`
+  const rangeLabel = suggested.referenceLabel || suggested.latestTag
+    ? `based on changes since ${suggested.referenceLabel || suggested.latestTag}`
     : 'based on recent changes'
 
   if (!interactive || typeof runPrompt !== 'function') {