Migration Guide

Migrating to @waiyat/devops v3.0.0

Breaking changes, new commands, updated flags, and step-by-step upgrade instructions from v2.x.

Quick Upgrade

bash

npm install --save-dev @waiyat/devops@latest

Or run directly: npx @waiyat/devops@latest check

Breaking Changes

These changes require action when upgrading from v2.x to v3.0.0.

Node.js Version

High Impact

v2.x

Node.js v16+ supported

v3.0.0

Node.js v18.0.0 minimum (v20+ LTS recommended)

Pipeline Architecture

Medium Impact

v2.x

4-step: Detector → Project IR → Diagnostics → Workflow Scaffolding

v3.0.0

5-stage: Detector → Project IR → Diagnostics → Scoring Layer → Scaffolding & Auto-Fix

Package Version

High Impact

v2.x

@waiyat/devops@^2.1.0

v3.0.0

@waiyat/devops@^3.0.0

npx Invocation

Medium Impact

v2.x

npx @waiyat/devops@latest (v2.x binary)

v3.0.0

npx @waiyat/devops@latest (v3.0.0 binary — always use @latest)

New Commands

New Commands in v3.0.0

Three new lifecycle commands added to the CLI suite.

add <recipe>

New

Scaffold a modular recipe (e.g. `security/dependency-scan`, `docker/build-push`).

bash

npx @waiyat/devops@latest add security/dependency-scan

clean [--dry-run]

New

Remove build outputs (.next, dist, coverage) and stale caches.

bash

npx @waiyat/devops@latest clean --dry-run

release [--dry-run]

New

Semantic versioning, changelog generation, and git release tags.

bash

npx @waiyat/devops@latest release --dry-run

Updated Flags

Updated Command Flags

Existing commands received new flags and options in v3.0.0.

Command	v2.x	v3.0.0	Example
fix	--template, -t only	Adds `--issue <category>` for granular auto-repair targeting	npx @waiyat/devops@latest fix --issue security
init	--template (nextjs, node, docker, etc.)	Adds `--template pro` (S4 enterprise), `--force` to overwrite	npx @waiyat/devops@latest init --template pro --force
doctor	--verbose, -v only	Adds `--yes` for non-interactive auto-remediation	npx @waiyat/devops@latest doctor --yes
check	--json, --verbose, --fix, --pr	Same flags — output now includes Scoring layer category breakdowns	npx @waiyat/devops@latest check --json

Deprecated Items

Removed or Changed Behavior

Items that were removed or significantly changed in v3.0.0.

Minimum Node.js v16

Raised to v18.0.0 (v20+ LTS recommended)

Upgrade Node.js before installing v3.0.0

4-step pipeline

Expanded to 5-stage with dedicated Scoring layer

Review new scoring output in `check --json`

Checklist

Upgrade Checklist

Update package.json: `@waiyat/devops: ^3.0.0`

Verify Node.js >= v18.0.0 (v20+ LTS recommended)

Run `npx @waiyat/devops@latest --version` to confirm v3.0.0

Review `check --json` output for new Scoring layer data

Update CI workflows if referencing v2.x-specific flags

Test `fix --issue <category>` for targeted auto-repair

Try `init --template pro` for enterprise pipeline scaffolding

Need help? View full changelog or open an issue.