@wyxos/zephyr 0.9.5 → 0.9.6

package/package.json

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

package/src/release/commit-message.mjs

@@ -3,6 +3,7 @@ import {tmpdir} from 'node:os'
 import path from 'node:path'
 import process from 'node:process'
 
+import {describeCodexAdvisorFailure, logCapturedCodexDiagnostics} from '../runtime/codex-diagnostics.mjs'
 import {commandExists} from '../utils/command.mjs'
 
 const CONVENTIONAL_COMMIT_PATTERN = /^(build|chore|ci|docs|feat|fix|perf|refactor|revert|style|test): .+/i
@@ -237,7 +238,7 @@ export async function suggestCommitMessage(rootDir = process.cwd(), {
 
     logStep?.('Generating a suggested commit message with Codex...')
 
-    await runCommand('codex', [
+    const codexResult = await runCommand('codex', [
       'exec',
       '--ephemeral',
       '--model',
@@ -258,6 +259,7 @@ export async function suggestCommitMessage(rootDir = process.cwd(), {
       capture: true,
       cwd: rootDir
     })
+    logCapturedCodexDiagnostics(codexResult, {label: 'commit-message advisor', logWarning})
 
     const rawMessage = await readFile(outputPath, 'utf8')
     const message = sanitizeSuggestedCommitMessage(rawMessage)
@@ -269,7 +271,7 @@ export async function suggestCommitMessage(rootDir = process.cwd(), {
     logWarning?.('Codex suggested an unusable commit message.')
     return fallbackMessage()
   } catch (error) {
-    logWarning?.(`Codex could not suggest a commit message: ${error.message}`)
+    logWarning?.(`${describeCodexAdvisorFailure(error, {label: 'commit-message advisor'})} Using path-based fallback.`)
     return fallbackMessage()
   } finally {
     if (tempDir) {

package/src/release/release-type.mjs

@@ -4,6 +4,7 @@ import path from 'node:path'
 import process from 'node:process'
 import semver from 'semver'
 
+import {describeCodexAdvisorFailure, logCapturedCodexDiagnostics} from '../runtime/codex-diagnostics.mjs'
 import {commandExists} from '../utils/command.mjs'
 
 export const RELEASE_TYPES = [
@@ -240,7 +241,7 @@ async function suggestReleaseType(rootDir = process.cwd(), {
 
     logStep?.('Evaluating the recommended version bump with Codex...')
 
-    await runCommand('codex', [
+    const codexResult = await runCommand('codex', [
       'exec',
       '--ephemeral',
       '--model',
@@ -267,6 +268,7 @@ async function suggestReleaseType(rootDir = process.cwd(), {
       capture: true,
       cwd: rootDir
     })
+    logCapturedCodexDiagnostics(codexResult, {label: 'release advisor', logWarning})
 
     const rawSuggestion = await readFile(outputPath, 'utf8')
     const releaseType = sanitizeSuggestedReleaseType(rawSuggestion, allowedSuggestedReleaseTypes)
@@ -287,7 +289,7 @@ async function suggestReleaseType(rootDir = process.cwd(), {
       source: flooredReleaseType === releaseType ? 'codex' : 'codex+heuristic-floor'
     }
   } catch (error) {
-    logWarning?.(`Codex could not suggest a release type: ${error.message}`)
+    logWarning?.(`${describeCodexAdvisorFailure(error, {label: 'release advisor'})} Using heuristic release type.`)
 
     return {
       ...context,

package/src/runtime/codex-diagnostics.mjs

@@ -0,0 +1,62 @@
+function splitLines(text = '') {
+  return String(text)
+    .split(/\r?\n/)
+    .map((line) => line.trim())
+    .filter(Boolean)
+}
+
+function normalizeCapturedOutput(commandOutput = {}) {
+  if (typeof commandOutput === 'string') {
+    return {stdout: commandOutput, stderr: ''}
+  }
+
+  return {
+    stdout: commandOutput?.stdout ?? '',
+    stderr: commandOutput?.stderr ?? ''
+  }
+}
+
+export function collectCodexDiagnosticLines(commandOutput = {}) {
+  const {stdout, stderr} = normalizeCapturedOutput(commandOutput)
+  const stderrLines = splitLines(stderr)
+  const stdoutDiagnosticLines = splitLines(stdout)
+    .filter((line) => /\b(error|warn|warning|failed|failure|rejected|declined)\b/i.test(line))
+
+  return [...stderrLines, ...stdoutDiagnosticLines]
+}
+
+export function logCapturedCodexDiagnostics(commandOutput = {}, {
+  label = 'advisor',
+  logWarning
+} = {}) {
+  const diagnosticCount = collectCodexDiagnosticLines(commandOutput).length
+
+  if (diagnosticCount === 0) {
+    return
+  }
+
+  const noun = diagnosticCount === 1 ? 'line' : 'lines'
+  logWarning?.(
+    `Codex ${label} emitted ${diagnosticCount} diagnostic ${noun}; ` +
+    'captured and hidden because the advisor returned a usable result.'
+  )
+}
+
+export function describeCodexAdvisorFailure(error, {
+  label = 'advisor'
+} = {}) {
+  const diagnosticCount = collectCodexDiagnosticLines(error).length
+  const exitCode = error?.exitCode
+  const exitText = exitCode == null ? 'failed' : `exited with code ${exitCode}`
+
+  if (diagnosticCount > 0) {
+    const noun = diagnosticCount === 1 ? 'line' : 'lines'
+    return `Codex ${label} ${exitText}; captured ${diagnosticCount} diagnostic ${noun}.`
+  }
+
+  if (error?.code === 'ENOENT') {
+    return `Codex ${label} failed because the codex command was not found.`
+  }
+
+  return `Codex ${label} ${exitText}.`
+}

package/src/runtime/local-command.mjs

@@ -6,10 +6,24 @@ export function createLocalCommandRunners({ runCommandBase, runCommandCaptureBas
   }
 
   const runCommand = async (command, args, {
+    capture = false,
     silent = false,
     cwd,
     forwardStdoutToStderr = false
   } = {}) => {
+    if (capture) {
+      const captured = await runCommandCaptureBase(command, args, {cwd})
+
+      if (typeof captured === 'string') {
+        return {stdout: captured.trim(), stderr: ''}
+      }
+
+      return {
+        stdout: (captured?.stdout ?? '').trim(),
+        stderr: (captured?.stderr ?? '').trim()
+      }
+    }
+
     const stdio = silent
       ? 'ignore'
       : forwardStdoutToStderr