@wyxos/zephyr 0.9.3 → 0.9.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wyxos/zephyr",
-  "version": "0.9.3",
+  "version": "0.9.5",
   "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

@@ -22,6 +22,25 @@ async function isGitIgnored(rootDir, filePath, {runCommand} = {}) {
     }
 }
 
+
+async function captureGit(rootDir, args, {runCommand, runCommandCapture} = {}) {
+    if (typeof runCommandCapture === 'function') {
+        return await runCommandCapture('git', args, {cwd: rootDir})
+    }
+
+    if (typeof runCommand !== 'function') {
+        return ''
+    }
+
+    const output = await runCommand('git', args, {capture: true, cwd: rootDir})
+
+    if (typeof output === 'string') {
+        return output
+    }
+
+    return output?.stdout ?? ''
+}
+
 function parseVersionBumpCommit(line) {
     const [hash, shortHash, subject] = line.split('\0')
     const match = /^chore: bump version to (\d+\.\d+\.\d+(?:[-+][^\s]+)?)$/i.exec(subject ?? '')
@@ -33,15 +52,11 @@ function parseVersionBumpCommit(line) {
     return {hash, shortHash, version: match[1]}
 }
 
-async function readVersionBumpCommits(rootDir, {runCommand} = {}) {
-    if (typeof runCommand !== 'function') {
-        return []
-    }
-
+async function readVersionBumpCommits(rootDir, {runCommand, runCommandCapture} = {}) {
     try {
-        const {stdout = ''} = await runCommand('git', ['log', '--format=%H%x00%h%x00%s', '-1000'], {
-            capture: true,
-            cwd: rootDir
+        const stdout = await captureGit(rootDir, ['log', '--format=%H%x00%h%x00%s', '-1000'], {
+            runCommand,
+            runCommandCapture
         })
 
         return stdout
@@ -97,12 +112,48 @@ function formatVersionReferenceLabel(reference, currentVersion) {
     return `${prefix} ${reference.shortHash} (${reference.version})`
 }
 
+
+async function readRecentAppCommitSubjects(rootDir, versionReference, {runCommand, runCommandCapture} = {}) {
+    if (!versionReference?.hash) {
+        return ''
+    }
+
+    try {
+        const stdout = await captureGit(rootDir, [
+            'log',
+            '--format=%s',
+            '--max-count=80',
+            `${versionReference.hash}..HEAD`
+        ], {
+            runCommand,
+            runCommandCapture
+        })
+
+        return stdout.trim()
+    } catch {
+        return ''
+    }
+}
+
+function inferMinimumReleaseTypeFromCommitSubjects(commitSubjects) {
+    if (/breaking change|breaking changes|^[a-z]+(?:\(.+\))?!:/im.test(commitSubjects)) {
+        return 'major'
+    }
+
+    if (/\bfeat(?:\(.+\))?:/im.test(commitSubjects)) {
+        return 'minor'
+    }
+
+    return null
+}
+
 async function resolveDeploymentVersionValue(rootDir, {
     versionArg = null,
     pkg,
     interactive = false,
     runPrompt,
     runCommand,
+    runCommandCapture,
     logProcessing,
     logWarning
 } = {}) {
@@ -110,8 +161,9 @@ async function resolveDeploymentVersionValue(rootDir, {
         return String(versionArg).trim()
     }
 
-    const versionBumps = await readVersionBumpCommits(rootDir, {runCommand})
+    const versionBumps = await readVersionBumpCommits(rootDir, {runCommand, runCommandCapture})
     const versionReference = selectVersionSuggestionReference(pkg.version, versionBumps)
+    const commitSubjects = await readRecentAppCommitSubjects(rootDir, versionReference, {runCommand, runCommandCapture})
 
     return await resolveReleaseType({
         currentVersion: pkg.version,
@@ -120,10 +172,12 @@ async function resolveDeploymentVersionValue(rootDir, {
         interactive,
         runPrompt,
         runCommand,
+        runCommandCapture,
         logStep: logProcessing,
         logWarning,
         latestTag: versionReference?.hash ?? null,
-        referenceLabel: formatVersionReferenceLabel(versionReference, pkg.version)
+        referenceLabel: formatVersionReferenceLabel(versionReference, pkg.version),
+        minimumReleaseType: inferMinimumReleaseTypeFromCommitSubjects(commitSubjects)
     })
 }
 
@@ -133,6 +187,7 @@ export async function bumpLocalPackageVersion(rootDir, {
     runPrompt,
     skipGitHooks = false,
     runCommand,
+    runCommandCapture,
     logProcessing,
     logSuccess,
     logWarning
@@ -159,6 +214,7 @@ export async function bumpLocalPackageVersion(rootDir, {
         interactive,
         runPrompt,
         runCommand,
+        runCommandCapture,
         logProcessing,
         logWarning
     })

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

@@ -70,6 +70,7 @@ export async function prepareLocalDeployment(config, {
                 interactive,
                 runPrompt,
                 runCommand,
+                runCommandCapture,
                 logProcessing,
                 logSuccess,
                 logWarning

package/src/release/release-type.mjs

@@ -79,12 +79,12 @@ function inferReleaseTypeHeuristically({
   return 'patch'
 }
 
-function applyHeuristicFloor(releaseType, heuristicReleaseType) {
+function applyReleaseTypeFloor(releaseType, floorReleaseType) {
   const releaseWeight = RELEASE_TYPE_WEIGHTS[releaseType] ?? -1
-  const heuristicWeight = RELEASE_TYPE_WEIGHTS[heuristicReleaseType] ?? -1
+  const floorWeight = RELEASE_TYPE_WEIGHTS[floorReleaseType] ?? -1
 
-  if (heuristicWeight > releaseWeight) {
-    return heuristicReleaseType
+  if (floorWeight > releaseWeight) {
+    return floorReleaseType
   }
 
   return releaseType
@@ -107,14 +107,30 @@ function buildChoiceOrder(suggestedReleaseType) {
   ]
 }
 
-async function readLatestReleaseTag(rootDir, {runCommand, latestTag = null} = {}) {
+
+async function captureCommand(command, args, {runCommand, runCommandCapture, cwd} = {}) {
+  if (typeof runCommandCapture === 'function') {
+    return {stdout: await runCommandCapture(command, args, {cwd}), stderr: ''}
+  }
+
+  const output = await runCommand(command, args, {capture: true, cwd})
+
+  if (typeof output === 'string') {
+    return {stdout: output, stderr: ''}
+  }
+
+  return output ?? {stdout: '', stderr: ''}
+}
+
+async function readLatestReleaseTag(rootDir, {runCommand, runCommandCapture, latestTag = null} = {}) {
   if (typeof latestTag === 'string' && latestTag.trim() !== '') {
     return latestTag.trim()
   }
 
   try {
-    const {stdout} = await runCommand('git', ['describe', '--tags', '--abbrev=0'], {
-      capture: true,
+    const {stdout} = await captureCommand('git', ['describe', '--tags', '--abbrev=0'], {
+      runCommand,
+      runCommandCapture,
       cwd: rootDir
     })
 
@@ -124,14 +140,15 @@ async function readLatestReleaseTag(rootDir, {runCommand, latestTag = null} = {}
   }
 }
 
-async function readCommitLog(rootDir, {runCommand, latestTag} = {}) {
+async function readCommitLog(rootDir, {runCommand, runCommandCapture, latestTag} = {}) {
   const args = latestTag
     ? ['log', '--format=%h %s', `${latestTag}..HEAD`]
     : ['log', '--format=%h %s', '-20']
 
   try {
-    const {stdout} = await runCommand('git', args, {
-      capture: true,
+    const {stdout} = await captureCommand('git', args, {
+      runCommand,
+      runCommandCapture,
       cwd: rootDir
     })
 
@@ -141,14 +158,15 @@ async function readCommitLog(rootDir, {runCommand, latestTag} = {}) {
   }
 }
 
-async function readDiffStat(rootDir, {runCommand, latestTag} = {}) {
+async function readDiffStat(rootDir, {runCommand, runCommandCapture, latestTag} = {}) {
   const args = latestTag
     ? ['diff', '--stat', `${latestTag}..HEAD`, '--']
     : ['diff', '--stat', 'HEAD~20..HEAD', '--']
 
   try {
-    const {stdout} = await runCommand('git', args, {
-      capture: true,
+    const {stdout} = await captureCommand('git', args, {
+      runCommand,
+      runCommandCapture,
       cwd: rootDir
     })
 
@@ -160,14 +178,15 @@ async function readDiffStat(rootDir, {runCommand, latestTag} = {}) {
 
 async function buildReleaseSuggestionContext(rootDir, {
   runCommand,
+  runCommandCapture,
   currentVersion,
   packageName,
   latestTag = null,
   referenceLabel = null
 } = {}) {
-  const resolvedLatestTag = await readLatestReleaseTag(rootDir, {runCommand, latestTag})
-  const commitLog = await readCommitLog(rootDir, {runCommand, latestTag: resolvedLatestTag})
-  const diffStat = await readDiffStat(rootDir, {runCommand, latestTag: resolvedLatestTag})
+  const resolvedLatestTag = await readLatestReleaseTag(rootDir, {runCommand, runCommandCapture, latestTag})
+  const commitLog = await readCommitLog(rootDir, {runCommand, runCommandCapture, latestTag: resolvedLatestTag})
+  const diffStat = await readDiffStat(rootDir, {runCommand, runCommandCapture, latestTag: resolvedLatestTag})
 
   return {
     currentVersion,
@@ -181,23 +200,29 @@ async function buildReleaseSuggestionContext(rootDir, {
 
 async function suggestReleaseType(rootDir = process.cwd(), {
   runCommand,
+  runCommandCapture,
   currentVersion,
   packageName,
   commandExistsImpl = commandExists,
   logStep,
   logWarning,
   latestTag = null,
-  referenceLabel = null
+  referenceLabel = null,
+  minimumReleaseType = null
 } = {}) {
   const context = await buildReleaseSuggestionContext(rootDir, {
     runCommand,
+    runCommandCapture,
     currentVersion,
     packageName,
     latestTag,
     referenceLabel
   })
   const allowedSuggestedReleaseTypes = resolveSuggestedReleaseTypeOptions(currentVersion)
-  const heuristicReleaseType = inferReleaseTypeHeuristically(context)
+  const heuristicReleaseType = applyReleaseTypeFloor(
+    inferReleaseTypeHeuristically(context),
+    sanitizeSuggestedReleaseType(minimumReleaseType, allowedSuggestedReleaseTypes)
+  )
 
   if (!commandExistsImpl('codex')) {
     return {
@@ -254,7 +279,7 @@ async function suggestReleaseType(rootDir = process.cwd(), {
       }
     }
 
-    const flooredReleaseType = applyHeuristicFloor(releaseType, heuristicReleaseType)
+    const flooredReleaseType = applyReleaseTypeFloor(releaseType, heuristicReleaseType)
 
     return {
       ...context,
@@ -284,10 +309,12 @@ export async function resolveReleaseType({
   interactive = true,
   runPrompt,
   runCommand,
+  runCommandCapture,
   logStep,
   logWarning,
   latestTag = null,
-  referenceLabel = null
+  referenceLabel = null,
+  minimumReleaseType = null
 } = {}) {
   if (releaseType) {
     return releaseType
@@ -295,12 +322,14 @@ export async function resolveReleaseType({
 
   const suggested = await suggestReleaseType(rootDir, {
     runCommand,
+    runCommandCapture,
     currentVersion,
     packageName,
     logStep,
     logWarning,
     latestTag,
-    referenceLabel
+    referenceLabel,
+    minimumReleaseType
   })
   const rangeLabel = suggested.referenceLabel || suggested.latestTag
     ? `based on changes since ${suggested.referenceLabel || suggested.latestTag}`