@wyxos/zephyr 0.3.0 → 0.3.1

package/README.md

@@ -16,7 +16,7 @@ npx @wyxos/zephyr
 
 ## Usage
 
-Navigate to your project directory and run:
+Navigate to your app or package directory and run:
 
 ```bash
 npm run release
@@ -34,13 +34,27 @@ See all flags:
 zephyr --help
 ```
 
-Common flags:
+Common workflows:
 
 ```bash
-# Run a release workflow
+# Deploy an app using the saved preset or the interactive prompts
+zephyr
+
+# Deploy an app and bump the local npm package version first
+zephyr minor
+
+# Release a Node/Vue package (defaults to a patch bump)
 zephyr --type node
+
+# Release a Node/Vue package with an explicit bump
+zephyr --type node minor
+
+# Release a Packagist package
+zephyr --type packagist patch
 ```
 
+When `--type node` or `--type vue` is used without a bump argument, Zephyr defaults to `patch`.
+
 On a first run inside a project with `package.json`, Zephyr can:
 - add `.zephyr/` to `.gitignore`
 - add a `release` script that runs `npx @wyxos/zephyr@latest`
@@ -54,47 +68,17 @@ Follow the interactive prompts to configure your deployment target:
 
 Configuration is saved automatically for future deployments.
 
-## Scripts
+## Project Scripts
 
-Zephyr exposes the following common project workflow:
+The recommended entrypoint in consumer projects is:
 
 ```bash
-npm run lint
-npm test
 npm run release
 ```
 
-- `npm run lint` runs `eslint . --fix`, so it can rewrite tracked files when auto-fixes are available.
-- `npm test` runs the Vitest suite.
-- `npm run release` is the recommended project entrypoint once the release script has been installed.
-
-## Package API
-
-The package surface is intentionally small:
-
-```js
-import {
-  logProcessing,
-  logSuccess,
-  logWarning,
-  logError,
-  runCommand,
-  runCommandCapture,
-  writeToLogFile
-} from '@wyxos/zephyr'
-
-import {selectDeploymentTarget} from '@wyxos/zephyr/targets'
-
-import {
-  connectToServer,
-  executeRemoteCommand,
-  readRemoteFile,
-  downloadRemoteFile,
-  deleteRemoteFile
-} from '@wyxos/zephyr/ssh'
-```
-
-The root package does not expose the old interactive configuration helper bag; target selection now lives under `@wyxos/zephyr/targets`.
+- `npm run release` is the recommended app/package entrypoint once the release script has been installed.
+- For `--type node` workflows, Zephyr runs your project's `lint` script when present.
+- For `--type node` workflows, Zephyr runs `test:run` or `test` when present.
 
 ## Features
 

package/bin/zephyr.mjs

@@ -12,8 +12,11 @@ const program = new Command()
 program
   .name('zephyr')
   .description('A streamlined deployment tool for web applications with intelligent Laravel project detection')
-  .option('--type <type>', 'Release type (node|vue|packagist)')
-  .argument('[version]', 'Version or npm bump type (e.g. 1.2.3, patch, minor, major)')
+  .option('--type <type>', 'Workflow type (node|vue|packagist). Omit for normal app deployments.')
+  .argument(
+    '[version]',
+    'Version or npm bump type for deployments (e.g. 1.2.3, patch, minor, major). --type node/vue/packagist workflows accept bump types only and default to patch.'
+  )
 
 program.parse(process.argv)
 const options = program.opts()

package/package.json

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

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

@@ -191,6 +191,7 @@ async function bumpVersion(releaseType, rootDir = process.cwd(), {logStep, logSu
     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', ['tag', '-fa', `v${pkg.version}`, '-m', `v${pkg.version}`], {capture: true, cwd: rootDir})
 
     logSuccess?.(`Version updated to ${pkg.version}.`)
     return pkg

package/src/deploy/local-repo.mjs

@@ -7,7 +7,7 @@ export async function getCurrentBranch(rootDir) {
 
 export async function getGitStatus(rootDir, { runCommandCapture } = {}) {
   const output = await runCommandCapture('git', ['status', '--porcelain'], { cwd: rootDir })
-  return output.trim()
+  return output.trimEnd()
 }
 
 export function hasStagedChanges(statusOutput) {

package/src/index.mjs

@@ -1,22 +1,12 @@
 import {writeToLogFile} from './utils/log-file.mjs'
 import {createAppContext} from './runtime/app-context.mjs'
 
-export {main, runRemoteTasks} from './main.mjs'
-export {
-    connectToServer,
-    executeRemoteCommand,
-    readRemoteFile,
-    downloadRemoteFile,
-    deleteRemoteFile
-} from './ssh/index.mjs'
-
 const appContext = createAppContext()
 const {
     logProcessing,
     logSuccess,
     logWarning,
     logError,
-    createSshClient,
     runCommand,
     runCommandCapture
 } = appContext
@@ -28,6 +18,5 @@ export {
     logError,
     runCommand,
     runCommandCapture,
-    writeToLogFile,
-    createSshClient
+    writeToLogFile
 }

package/src/release/shared.mjs

@@ -29,7 +29,23 @@ export function parseReleaseArgs({
   args = process.argv.slice(2),
   booleanFlags = []
 } = {}) {
-  const filteredArgs = args.filter((arg) => !arg.startsWith('--type='))
+  const filteredArgs = []
+
+  for (let index = 0; index < args.length; index += 1) {
+    const arg = args[index]
+
+    if (arg === '--type') {
+      index += 1
+      continue
+    }
+
+    if (arg.startsWith('--type=')) {
+      continue
+    }
+
+    filteredArgs.push(arg)
+  }
+
   const positionals = filteredArgs.filter((arg) => !arg.startsWith('--'))
   const presentFlags = new Set(filteredArgs.filter((arg) => arg.startsWith('--')))
   const releaseType = positionals[0] ?? 'patch'