@wyxos/zephyr 0.4.8 → 0.4.9

package/package.json

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

package/src/main.mjs

@@ -17,6 +17,7 @@ import {selectDeploymentTarget} from './application/configuration/select-deploym
 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'
+import {notifyWorkflowResult} from './utils/notifications.mjs'
 
 const RELEASE_SCRIPT_NAME = 'release'
 const RELEASE_SCRIPT_COMMAND = 'npx @wyxos/zephyr@latest'
@@ -99,6 +100,7 @@ async function runRemoteTasks(config, options = {}) {
 
 async function main(optionsOrWorkflowType = null, versionArg = null) {
     const options = normalizeMainOptions(optionsOrWorkflowType, versionArg)
+    const rootDir = process.cwd()
 
     const executionMode = {
         interactive: !options.nonInteractive,
@@ -171,6 +173,14 @@ async function main(optionsOrWorkflowType = null, versionArg = null) {
                     workflow: currentExecutionMode.workflow
                 }
             })
+            if (!currentExecutionMode.json) {
+                await notifyWorkflowResult({
+                    status: 'success',
+                    workflow: currentExecutionMode.workflow,
+                    presetName: currentExecutionMode.presetName,
+                    rootDir
+                })
+            }
             return
         }
 
@@ -189,11 +199,17 @@ async function main(optionsOrWorkflowType = null, versionArg = null) {
                     workflow: currentExecutionMode.workflow
                 }
             })
+            if (!currentExecutionMode.json) {
+                await notifyWorkflowResult({
+                    status: 'success',
+                    workflow: currentExecutionMode.workflow,
+                    presetName: currentExecutionMode.presetName,
+                    rootDir
+                })
+            }
             return
         }
 
-        const rootDir = process.cwd()
-
         await bootstrap.ensureGitignoreEntry(rootDir, {
             projectConfigDir: PROJECT_CONFIG_DIR,
             runCommand,
@@ -256,6 +272,14 @@ async function main(optionsOrWorkflowType = null, versionArg = null) {
                 workflow: currentExecutionMode.workflow
             }
         })
+        if (!currentExecutionMode.json) {
+            await notifyWorkflowResult({
+                status: 'success',
+                workflow: currentExecutionMode.workflow,
+                presetName: currentExecutionMode.presetName,
+                rootDir
+            })
+        }
     } catch (error) {
         const errorCode = getErrorCode(error)
         emitEvent?.('run_failed', {
@@ -272,6 +296,13 @@ async function main(optionsOrWorkflowType = null, versionArg = null) {
             if (errorCode === 'ZEPHYR_FAILURE' && error.stack) {
                 writeStderrLine(error.stack)
             }
+            await notifyWorkflowResult({
+                status: 'failure',
+                workflow: currentExecutionMode.workflow,
+                presetName: currentExecutionMode.presetName,
+                rootDir,
+                message: error.message
+            })
         }
 
         throw error

package/src/utils/notifications.mjs

@@ -0,0 +1,101 @@
+import path from 'node:path'
+import process from 'node:process'
+
+import {commandExists, runCommand as runCommandBase} from './command.mjs'
+
+const MAX_NOTIFICATION_MESSAGE_LENGTH = 180
+
+function escapeAppleScriptString(value = '') {
+  return String(value ?? '')
+    .replace(/\\/g, '\\\\')
+    .replace(/"/g, '\\"')
+}
+
+function humanizeWorkflow(workflow = 'deploy') {
+  if (workflow === 'release-node') {
+    return 'Node Release'
+  }
+
+  if (workflow === 'release-packagist') {
+    return 'Packagist Release'
+  }
+
+  return 'Deploy'
+}
+
+function truncateNotificationMessage(message = '') {
+  const normalized = String(message ?? '').replace(/\s+/g, ' ').trim()
+
+  if (normalized.length <= MAX_NOTIFICATION_MESSAGE_LENGTH) {
+    return normalized
+  }
+
+  return `${normalized.slice(0, MAX_NOTIFICATION_MESSAGE_LENGTH - 1).trimEnd()}…`
+}
+
+function buildNotificationPayload({
+  status = 'success',
+  workflow = 'deploy',
+  presetName = null,
+  rootDir = process.cwd(),
+  message = ''
+} = {}) {
+  const isSuccess = status === 'success'
+  const repoName = path.basename(rootDir || process.cwd()) || 'project'
+  const title = isSuccess ? '🟢 Zephyr Passed' : '🔴 Zephyr Failed'
+  const subtitleParts = [humanizeWorkflow(workflow), repoName]
+
+  if (presetName) {
+    subtitleParts.push(presetName)
+  }
+
+  return {
+    title,
+    subtitle: subtitleParts.join(' • '),
+    message: isSuccess
+      ? 'Workflow completed successfully.'
+      : truncateNotificationMessage(message || 'Workflow failed.'),
+    soundName: isSuccess ? 'Glass' : 'Basso'
+  }
+}
+
+export async function notifyWorkflowResult({
+  status = 'success',
+  workflow = 'deploy',
+  presetName = null,
+  rootDir = process.cwd(),
+  message = ''
+} = {}, {
+  processRef = process,
+  commandExistsImpl = commandExists,
+  runCommand = runCommandBase
+} = {}) {
+  if (processRef.platform !== 'darwin' || !commandExistsImpl('osascript')) {
+    return false
+  }
+
+  const payload = buildNotificationPayload({
+    status,
+    workflow,
+    presetName,
+    rootDir,
+    message
+  })
+
+  const script = [
+    `display notification "${escapeAppleScriptString(payload.message)}"`,
+    `with title "${escapeAppleScriptString(payload.title)}"`,
+    `subtitle "${escapeAppleScriptString(payload.subtitle)}"`,
+    `sound name "${escapeAppleScriptString(payload.soundName)}"`
+  ].join(' ')
+
+  try {
+    await runCommand('osascript', ['-e', script], {
+      cwd: rootDir,
+      stdio: 'ignore'
+    })
+    return true
+  } catch {
+    return false
+  }
+}