Update docs for scaffold unittest v0.4.0: README, QUICKSTART, hugo reference and getting-started

Co-authored-by: chefgs <7605658+chefgs@users.noreply.github.com>

Author: Copilot

README.md

@@ -6,7 +6,7 @@
 
 [![CI](https://github.com/cloudengine-labs/devops_os/actions/workflows/ci.yml/badge.svg)](https://github.com/cloudengine-labs/devops_os/actions/workflows/ci.yml)
 [![Sanity Tests](https://github.com/cloudengine-labs/devops_os/actions/workflows/sanity.yml/badge.svg)](https://github.com/cloudengine-labs/devops_os/actions/workflows/sanity.yml)
-[![Version](https://img.shields.io/badge/version-0.2.0-blue)](CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-0.4.0-blue)](CHANGELOG.md)
 [![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue?logo=python&logoColor=white)](https://www.python.org/)
 [![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)
 [![Open Source](https://img.shields.io/badge/open%20source-%E2%9D%A4-red)](https://github.com/cloudengine-labs/devops_os)
@@ -29,6 +29,7 @@ DevOps-OS is an open-source DevOps automation platform that scaffolds production
 | 🚀 **CI/CD Generators** | One-command scaffolding for GitHub Actions, GitLab CI, and Jenkins pipelines |
 | ☸️ **GitOps Config Generator** | Kubernetes manifests, ArgoCD Applications, and Flux CD Kustomizations |
 | 📊 **SRE Config Generator** | Prometheus alert rules, Grafana dashboards, and SLO manifests |
+| 🧪 **Unit Test Scaffold** | Generate pytest, Jest, Vitest, Mocha, or Go test configs with one command |
 | 🤖 **MCP Server** | Plug DevOps-OS tools into Claude or ChatGPT as native AI skills |
 | 🛠️ **Dev Container** | Pre-configured multi-language environment (Python · Java · Go · JavaScript) |
 | 🔄 **Process-First** | Built-in education on the Process-First SDLC philosophy and how it maps to every DevOps-OS tool |
@@ -174,6 +175,13 @@ python -m cli.devopsos scaffold sre --name my-app --team platform --slo-target 9
 # Dev container configuration → .devcontainer/devcontainer.json + .devcontainer/devcontainer.env.json
 python -m cli.devopsos scaffold devcontainer --languages python,go --cicd-tools docker,terraform --kubernetes-tools k9s,flux
 
+# Unit test configs + sample stubs (Python, JS, Go, TypeScript)
+python -m cli.devopsos scaffold unittest --name my-app --languages python
+python -m cli.devopsos scaffold unittest --name my-app --languages python,javascript,go
+
+# Combined GitHub Actions + Jenkins in one step
+python -m cli.devopsos scaffold cicd --name my-app --type build --languages python --github --jenkins
+
 # Kubernetes manifests
 python kubernetes/k8s-config-generator.py --name my-app --image ghcr.io/myorg/my-app:v1
 ```
@@ -218,7 +226,7 @@ git clone https://github.com/cloudengine-labs/devops_os.git && cd devops_os
 pip install -r cli/requirements.txt
 
 # ── Check version ──────────────────────────────────────────────────────────
-python -m cli.devopsos --version           # → devopsos version 0.2.0
+python -m cli.devopsos --version           # → devopsos version 0.4.0
 
 # ── Interactive project wizard ─────────────────────────────────────────────
 python -m cli.devopsos init                # guided setup for any project
@@ -247,6 +255,10 @@ python -m cli.devopsos scaffold devcontainer --languages python,go --cicd-tools
 # ── Combined CI/CD (GHA + Jenkins in one step) ────────────────────────────
 python -m cli.devopsos scaffold cicd --name my-app --type build --languages python --github --jenkins
 
+# ── Unit Tests ─────────────────────────────────────────────────────────────
+python -m cli.devopsos scaffold unittest --name my-app --languages python
+python -m cli.devopsos scaffold unittest --name my-app --languages python,javascript,go
+
 # ── Process-First philosophy ───────────────────────────────────────────────
 python -m cli.devopsos process-first                      # full overview
 python -m cli.devopsos process-first --section mapping    # which tool for which goal
@@ -268,7 +280,7 @@ python -m cli.devopsos scaffold gha --help
 devops_os/
 ├── .devcontainer/      # Dev container config (Dockerfile, devcontainer.json, setup scripts)
 ├── .github/workflows/  # CI, Sanity Tests, and GitHub Pages workflows
-├── cli/                # CLI scaffold tools (scaffold_gha, gitlab, jenkins, argocd, sre, devopsos)
+├── cli/                # CLI scaffold tools (scaffold_gha, gitlab, jenkins, argocd, sre, unittest, devopsos)
 ├── kubernetes/         # Kubernetes manifest generator
 ├── mcp_server/         # MCP server for AI assistant integration (Claude, ChatGPT)
 ├── skills/             # Claude & OpenAI tool/function definitions
@@ -291,7 +303,7 @@ pip install -r cli/requirements.txt -r mcp_server/requirements.txt pytest pytest
 python -m pytest cli/test_cli.py mcp_server/test_server.py tests/test_comprehensive.py -v
 ```
 
-**Latest results:** ✅ 162 passed · ⚠️ 3 xfailed (known tracked bugs) · ❌ 0 failed
+**Latest results:** ✅ 260 passed · ⚠️ 2 xfailed (known tracked bugs) · ❌ 0 failed
 
 | Report | Description |
 |--------|-------------|
@@ -346,7 +358,7 @@ You can also customize `.devcontainer/devcontainer.env.json` directly to enable
 |-------|-------------|
 | [🚀 Getting Started](docs/GETTING-STARTED.md) | Easy step-by-step guide — **start here** |
 | [📖 CLI Commands Reference](docs/CLI-COMMANDS-REFERENCE.md) | **Complete reference** — every option, input file, and output location |
-| [🖥️ CLI Test Report](docs/CLI-TEST-REPORT.md) | v0.2.0 CLI revamp test results — 52 tests, all passing |
+| [🖥️ CLI Test Report](docs/CLI-TEST-REPORT.md) | v0.4.0 CLI test results — 62 tests, all passing |
 | [🔄 Process-First Philosophy](docs/PROCESS-FIRST.md) | What Process-First means, how it maps to DevOps-OS, and AI learning tips |
 | [📦 Dev Container Setup](docs/DEVOPS-OS-README.md) | Set up and customize the dev container |
 | [⚡ Quick Start Reference](docs/DEVOPS-OS-QUICKSTART.md) | Essential CLI commands for all features |
@@ -355,6 +367,7 @@ You can also customize `.devcontainer/devcontainer.env.json` directly to enable
 | [🔧 Jenkins Pipeline Generator](docs/JENKINS-PIPELINE-README.md) | Generate and customize Jenkins pipelines |
 | [🔄 ArgoCD / Flux GitOps](docs/ARGOCD-README.md) | Generate ArgoCD Applications and Flux Kustomizations |
 | [📊 SRE Configuration](docs/SRE-CONFIGURATION-README.md) | Prometheus rules, Grafana dashboards, SLO manifests |
+| [🧪 Unit Test Scaffold](docs/CLI-COMMANDS-REFERENCE.md#devopsos-scaffold-unittest--unit-test-scaffold-generator) | Generate pytest, Jest, Vitest, Mocha, or Go test configs |
 | [☸️ Kubernetes Deployments](docs/KUBERNETES-DEPLOYMENT-README.md) | Generate and manage Kubernetes deployment configs |
 | [🤖 MCP Server](mcp_server/README.md) | Connect DevOps-OS tools to Claude or ChatGPT |
 | [🧠 AI Skills](skills/README.md) | Use DevOps-OS with the Anthropic API or OpenAI function calling |

docs/DEVOPS-OS-QUICKSTART.md

@@ -13,6 +13,7 @@ This guide provides the essential CLI commands for using all functionalities of
 - [GitOps / ArgoCD & Flux CD](#gitops--argocd--flux-cd)
 - [SRE Configuration](#sre-configuration)
 - [Container Configuration](#container-configuration)
+- [Unit Test Scaffold](#unit-test-scaffold)
 - [Common Options for All Generators](#common-options-for-all-generators)
 - [Troubleshooting](#troubleshooting)
 
@@ -365,19 +366,84 @@ cat > .devcontainer/devcontainer.env.json << EOF
 EOF
 ```
 
+## Unit Test Scaffold
+
+Generate ready-to-use unit test configuration files and sample test stubs for Python, JavaScript/TypeScript, and Go.
+
+### Python (pytest)
+
+```bash
+# Generate pytest.ini, conftest.py, and a sample test file
+python -m cli.devopsos scaffold unittest --name my-api --languages python
+
+# Without coverage configuration
+python -m cli.devopsos scaffold unittest --name my-api --languages python --no-coverage
+```
+
+**Output:** `pytest.ini`, `conftest.py`, `tests/__init__.py`, `tests/test_sample.py`
+
+### JavaScript / TypeScript
+
+```bash
+# JavaScript with Jest (default)
+python -m cli.devopsos scaffold unittest --name my-app --languages javascript --framework jest
+
+# JavaScript with Mocha
+python -m cli.devopsos scaffold unittest --name my-app --languages javascript --framework mocha
+
+# TypeScript with Vitest
+python -m cli.devopsos scaffold unittest --name my-app --languages typescript --framework vitest
+```
+
+**Output (Jest):** `jest.config.js`, `tests/sample.test.js`  
+**Output (Vitest):** `vitest.config.js`, `tests/sample.test.ts`  
+**Output (Mocha):** `.mocharc.js`, `tests/sample.test.js`
+
+### Go
+
+```bash
+# Generate a table-driven Go test file + Makefile
+python -m cli.devopsos scaffold unittest --name my-service --languages go
+```
+
+**Output:** `my_service_test.go`, `Makefile.test`
+
+### Multi-stack (all three in one command)
+
+```bash
+python -m cli.devopsos scaffold unittest --name my-platform --languages python,javascript,go
+```
+
+### All options
+
+```bash
+# Show all available options
+python -m cli.devopsos scaffold unittest --help
+```
+
+| Option | Env var | Default | Description |
+|--------|---------|---------|-------------|
+| `--name NAME` | `DEVOPS_OS_UNITTEST_NAME` | `my-app` | Project name |
+| `--languages LANGS` | `DEVOPS_OS_UNITTEST_LANGUAGES` | `python` | Comma-separated: `python`, `javascript`, `typescript`, `go` |
+| `--framework FW` | `DEVOPS_OS_UNITTEST_FRAMEWORK` | _(auto)_ | JS/TS override: `jest` \| `mocha` \| `vitest` |
+| `--coverage` / `--no-coverage` | `DEVOPS_OS_UNITTEST_COVERAGE` | `true` | Include or exclude coverage config |
+| `--output-dir DIR` | `DEVOPS_OS_UNITTEST_OUTPUT_DIR` | `.` | Root output directory |
+
+---
+
 ## Common Options for All Generators
 
-| Option | `scaffold gha` | `scaffold gitlab` | `scaffold jenkins` | `scaffold argocd` | `scaffold sre` | `scaffold devcontainer` | Description |
-|--------|:-:|:-:|:-:|:-:|:-:|:-:|-------------|
-| `--name` | ✓ | ✓ | ✓ | ✓ | ✓ | — | Name of the workflow/pipeline/app |
-| `--type` | ✓ | ✓ | ✓ | — | — | — | Type of workflow/pipeline |
-| `--languages` | ✓ | ✓ | ✓ | — | — | ✓ | Languages to enable |
-| `--kubernetes` | ✓ | ✓ | ✓ | — | — | — | Include K8s deployment steps |
-| `--k8s-method` | ✓ | ✓ | ✓ | — | — | — | K8s deployment method |
-| `--output` | ✓ | ✓ | ✓ | — | — | — | Output file path |
-| `--output-dir` | — | — | — | ✓ | ✓ | ✓ | Output directory |
-| `--custom-values` | ✓ | ✓ | ✓ | — | — | — | Custom configuration JSON file |
-| `--image` | ✓ | ✓ | ✓ | ✓ | — | — | Container image to use |
+| Option | `scaffold gha` | `scaffold gitlab` | `scaffold jenkins` | `scaffold argocd` | `scaffold sre` | `scaffold devcontainer` | `scaffold unittest` | Description |
+|--------|:-:|:-:|:-:|:-:|:-:|:-:|:-:|-------------|
+| `--name` | ✓ | ✓ | ✓ | ✓ | ✓ | — | ✓ | Name of the workflow/pipeline/app |
+| `--type` | ✓ | ✓ | ✓ | — | — | — | — | Type of workflow/pipeline |
+| `--languages` | ✓ | ✓ | ✓ | — | — | ✓ | ✓ | Languages to enable |
+| `--kubernetes` | ✓ | ✓ | ✓ | — | — | — | — | Include K8s deployment steps |
+| `--k8s-method` | ✓ | ✓ | ✓ | — | — | — | — | K8s deployment method |
+| `--output` | ✓ | ✓ | ✓ | — | — | — | — | Output file path |
+| `--output-dir` | — | — | — | ✓ | ✓ | ✓ | ✓ | Output directory |
+| `--custom-values` | ✓ | ✓ | ✓ | — | — | — | — | Custom configuration JSON file |
+| `--image` | ✓ | ✓ | ✓ | ✓ | — | — | — | Container image to use |
 
 ## Troubleshooting
 
@@ -389,6 +455,7 @@ python -m cli.devopsos scaffold jenkins --help
 python -m cli.devopsos scaffold argocd --help
 python -m cli.devopsos scaffold sre --help
 python -m cli.devopsos scaffold devcontainer --help
+python -m cli.devopsos scaffold unittest --help
 
 # Verify generated output locations
 ls -la .github/workflows/      # GitHub Actions

hugo-docs/content/docs/getting-started/_index.md

@@ -20,6 +20,7 @@ DevOps-OS is a toolkit that generates production-ready CI/CD pipelines, Kubernet
 | GitOps / Deploy | ArgoCD, Flux CD, kubectl, Kustomize |
 | Containers | Docker, Helm |
 | SRE / Observability | Prometheus alert rules, Grafana dashboards, SLO configs |
+| Unit Testing | pytest, Jest, Vitest, Mocha, Go test |
 | AI Integration | Claude (MCP Server), OpenAI (function calling) |
 
 ---
@@ -141,7 +142,27 @@ python -m cli.devopsos scaffold sre --name my-app --team platform
 
 ---
 
-## 6 — Interactive wizard (all-in-one)
+## 6 — Generate unit test configs
+
+```bash
+# Python — generates pytest.ini, conftest.py, and a sample test file
+python -m cli.devopsos scaffold unittest --name my-app --languages python
+
+# JavaScript with Jest
+python -m cli.devopsos scaffold unittest --name my-app --languages javascript --framework jest
+
+# TypeScript with Vitest
+python -m cli.devopsos scaffold unittest --name my-app --languages typescript --framework vitest
+
+# Multi-stack (Python + JavaScript + Go) in one command
+python -m cli.devopsos scaffold unittest --name my-platform --languages python,javascript,go
+```
+
+See [CLI Reference]({{< relref "/docs/reference" >}}) for all options and output file paths.
+
+---
+
+## 7 — Interactive wizard (all-in-one)
 
 ```bash
 python -m cli.devopsos init              # interactive project configurator
@@ -150,11 +171,13 @@ python -m cli.devopsos scaffold gitlab   # scaffold GitLab CI
 python -m cli.devopsos scaffold jenkins  # scaffold Jenkins
 python -m cli.devopsos scaffold argocd   # scaffold ArgoCD / Flux
 python -m cli.devopsos scaffold sre      # scaffold SRE configs
+python -m cli.devopsos scaffold cicd     # scaffold GHA + Jenkins in one step
+python -m cli.devopsos scaffold unittest # scaffold unit test configs
 ```
 
 ---
 
-## 7 — Use with an AI assistant
+## 8 — Use with an AI assistant
 
 ```bash
 pip install -r mcp_server/requirements.txt

hugo-docs/content/docs/reference/_index.md

@@ -21,6 +21,8 @@ Complete reference for every DevOps-OS CLI command: options, default values, env
 | Flux CD | `python -m cli.devopsos scaffold argocd --method flux` | `flux/` directory |
 | SRE configs | `python -m cli.devopsos scaffold sre` | `sre/` directory |
 | Dev Container | `python -m cli.devopsos scaffold devcontainer` | `.devcontainer/` directory |
+| Combined CI/CD | `python -m cli.devopsos scaffold cicd` | `.github/workflows/` + `Jenkinsfile` |
+| Unit Tests | `python -m cli.devopsos scaffold unittest` | varies by language (see below) |
 | Interactive wizard | `python -m cli.devopsos init` | varies |
 | Process-First guide | `python -m cli.devopsos process-first` | stdout (educational content) |
 
@@ -172,6 +174,28 @@ python -m cli.devopsos scaffold devcontainer [options]
 
 ---
 
+## scaffold unittest — Unit Test Scaffold
+
+```bash
+python -m cli.devopsos scaffold unittest [options]
+```
+
+| Option | Env var | Default | Description |
+|--------|---------|---------|-------------|
+| `--name NAME` | `DEVOPS_OS_UNITTEST_NAME` | `my-app` | Project name |
+| `--languages LANGS` | `DEVOPS_OS_UNITTEST_LANGUAGES` | `python` | Comma-separated: `python`, `javascript`, `typescript`, `go` |
+| `--framework FW` | `DEVOPS_OS_UNITTEST_FRAMEWORK` | _(auto)_ | JS/TS framework: `jest` \| `mocha` \| `vitest` |
+| `--coverage` / `--no-coverage` | `DEVOPS_OS_UNITTEST_COVERAGE` | `true` | Include or exclude coverage config |
+| `--output-dir DIR` | `DEVOPS_OS_UNITTEST_OUTPUT_DIR` | `.` | Root output directory |
+
+**Output (Python):** `pytest.ini`, `conftest.py`, `tests/__init__.py`, `tests/test_sample.py`  
+**Output (JS/TS Jest):** `jest.config.js`, `tests/sample.test.{js,ts}`  
+**Output (JS/TS Vitest):** `vitest.config.js`, `tests/sample.test.{js,ts}`  
+**Output (JS/TS Mocha):** `.mocharc.js`, `tests/sample.test.{js,ts}`  
+**Output (Go):** `<name>_test.go`, `Makefile.test`
+
+---
+
 ## devopsos — Unified CLI
 
 ```bash
@@ -193,6 +217,8 @@ python -m cli.devopsos scaffold jenkins      # Jenkins
 python -m cli.devopsos scaffold argocd       # ArgoCD / Flux
 python -m cli.devopsos scaffold sre          # SRE configs
 python -m cli.devopsos scaffold devcontainer # Dev container
+python -m cli.devopsos scaffold cicd         # Combined GHA + Jenkins
+python -m cli.devopsos scaffold unittest     # Unit test configs
 ```
 
 ### process-first command