Complete CLI Command Suite
All 17 official commands, options, and syntax examples provided by `@waiyat/devops`.
Always append @latest when invoking via npx (e.g. npx @waiyat/devops@latest sbom) to ensure npx executes the newest v2.0+ CLI binary rather than a cached local version.
devops check
coreRun real-time preflight diagnostics across 6 categories and calculate a weighted 0-100 repository health score.
Options & Flags
| Option Flag | Type | Default | Description |
|---|---|---|---|
| --json | boolean | — | Output raw machine-readable JSON (ideal for CI pipelines, PR bots, and dashboards). |
| --verbose, -v | boolean | — | Print full details including passed checks and actionable suggestions. |
| --fix | boolean | — | Automatically apply safe fixes during diagnostics check. |
| --pr | boolean | — | CI Pull Request mode (formats GitHub markdown table summary). |
Example Usage
npx @waiyat/devops@latest check --verbosedevops fix
coreAuto-repair repository misconfigurations: creates missing CI workflows, adds .dockerignore, updates .gitignore with .env protections, and injects non-root Docker USER.
Options & Flags
| Option Flag | Type | Default | Description |
|---|---|---|---|
| --dry-run | boolean | — | Preview changes and diff without modifying any files on disk. |
| --template, -t | string | — | Force a specific workflow template: 'nextjs' | 'node' | 'docker' | 'python' | 'go' | 'rust' | 'full'. |
Example Usage
npx @waiyat/devops@latest fixdevops doctor
coreInteractive diagnostic inspection with guided step-by-step auto-remediation for developers.
Options & Flags
| Option Flag | Type | Default | Description |
|---|---|---|---|
| --verbose, -v | boolean | — | Display verbose diagnostic probe outputs. |
Example Usage
npx @waiyat/devops@latest doctordevops init
workflowsIntelligently detect project stack and scaffold tailor-made, production-ready CI/CD pipelines.
Options & Flags
| Option Flag | Type | Default | Description |
|---|---|---|---|
| --template, -t | string | — | Force template (nextjs | node | docker | python | go | rust | full). |
| --output, -o | string | .github/workflows/ci.yml | Target file path for generated workflow. |
Example Usage
npx @waiyat/devops@latest init --template nextjsdevops validate
workflowsValidate local GitHub Actions workflow syntax, trigger events, and YAML integrity before pushing to remote.
Options & Flags
| Option Flag | Type | Default | Description |
|---|---|---|---|
| --verbose, -v | boolean | — | Print full workflow validation tree. |
Example Usage
npx @waiyat/devops@latest validatedevops security
securityPerform deep-dive DevSecOps audit, secret leak detection, and workflow least-privilege permission checks.
Options & Flags
| Option Flag | Type | Default | Description |
|---|---|---|---|
| --json | boolean | — | Output JSON vulnerability report. |
Example Usage
npx @waiyat/devops@latest securitydevops secrets
securityDiscover environment variables and API tokens used across source code and generate required GitHub Secrets manifest.
Options & Flags
| Option Flag | Type | Default | Description |
|---|---|---|---|
| --output, -o | string | — | Output format or destination file. |
Example Usage
npx @waiyat/devops@latest secretsdevops audit
securityLive dependency vulnerability and CVE inspection against global vulnerability advisories.
Options & Flags
| Option Flag | Type | Default | Description |
|---|---|---|---|
| --strict | boolean | — | Fail with non-zero exit code on any Moderate, High, or Critical finding. |
Example Usage
npx @waiyat/devops@latest auditdevops docker
containersAudit Dockerfiles for non-root users, multi-stage build caching, healthcheck probes, and .dockerignore parity.
Options & Flags
| Option Flag | Type | Default | Description |
|---|---|---|---|
| --fix | boolean | — | Automatically apply non-root user and .dockerignore remediations. |
Example Usage
npx @waiyat/devops@latest docker checkdevops env
coreValidate environment variable parity between active `.env` files and public `.env.example` templates.
Options & Flags
| Option Flag | Type | Default | Description |
|---|---|---|---|
| --fix | boolean | — | Generate missing .env.example with sanitized placeholder keys. |
Example Usage
npx @waiyat/devops@latest env --fixdevops sbom
governanceGenerate real Software Bill of Materials (SBOM) in CycloneDX v1.5 JSON standard with package purl identifiers.
Options & Flags
| Option Flag | Type | Default | Description |
|---|---|---|---|
| --output, -o | string | — | File destination (default prints JSON to stdout). |
Example Usage
npx @waiyat/devops@latest sbom -o ./sbom.jsondevops policy
governanceEvaluate repository against enterprise compliance rules (POL001: lockfiles, POL003: non-root, POL005: score >= 80).
Options & Flags
| Option Flag | Type | Default | Description |
|---|---|---|---|
| --json | boolean | — | Output machine-readable compliance report. |
Example Usage
npx @waiyat/devops@latest policy checkdevops diff
workflowsDetect configuration drift between local repository workflows and central upstream reusable recipes.
Options & Flags
| Option Flag | Type | Default | Description |
|---|---|---|---|
| --verbose | boolean | — | Print side-by-side YAML diff. |
Example Usage
npx @waiyat/devops@latest diffdevops list
workflowsBrowse modular, reusable enterprise workflow recipes available in @waiyat/devops.
Example Usage
npx @waiyat/devops@latest listdevops add
workflowsScaffold a specific modular recipe into your project (e.g. `security/dependency-scan`, `docker/build-push`).
Options & Flags
| Option Flag | Type | Default | Description |
|---|---|---|---|
| --force | boolean | — | Overwrite existing workflow without prompt. |
Example Usage
npx @waiyat/devops@latest add security/dependency-scandevops clean
maintenanceClean local build outputs (.next, dist, coverage), stale dependency caches, and reclaim disk space.
Options & Flags
| Option Flag | Type | Default | Description |
|---|---|---|---|
| --dry-run | boolean | — | Preview files to be deleted without deleting. |
Example Usage
npx @waiyat/devops@latest cleandevops release
governanceAutomate semantic versioning bumps, conventional changelog generation, and git release tags.
Options & Flags
| Option Flag | Type | Default | Description |
|---|---|---|---|
| --dry-run | boolean | — | Preview version bump without committing. |
Example Usage
npx @waiyat/devops@latest release