Add unit testing automation templates (scaffold unittest command)

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

Author: Copilot

CHANGELOG.md

@@ -7,6 +7,29 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [0.4.0] - 2026-03-15
+
+### Added
+- **`scaffold unittest` subcommand** — new `devopsos scaffold unittest` command that generates
+  unit testing configuration files and sample test stubs for multiple tech stacks:
+  - **Python** → `pytest.ini` (with pytest-cov options), `conftest.py` with shared fixtures,
+    `tests/__init__.py`, and `tests/test_sample.py` with parametrized examples.
+  - **JavaScript** → Jest (`jest.config.js`), Vitest (`vitest.config.js`), or Mocha (`.mocharc.js`)
+    configuration plus a matching `tests/sample.test.js`.
+  - **TypeScript** → same as JavaScript with TypeScript-specific Jest transform (`ts-jest`)
+    and `tests/sample.test.ts`.
+  - **Go** → table-driven `<name>_test.go` sample and `Makefile.test` with `test`, `test-race`,
+    `test-cov`, and `lint` targets.
+  - Coverage configuration is included by default and can be disabled with `--no-coverage`.
+  - Supports comma-separated `--languages` to scaffold multiple stacks at once.
+- **`generate_unittest_config` MCP tool** — exposes the new unit-test scaffold as an MCP tool
+  so AI assistants can generate test configurations via conversation.
+- **`cli/scaffold_unittest.py`** — the scaffold library backing the new command.
+- **`docs/CLI-COMMANDS-REFERENCE.md`** — new section documenting all `unittest` options,
+  output files, and examples.
+
+---
+
 ## [0.3.0] - 2026-03-10
 
 ### Fixed

cli/__version__.py

@@ -1,3 +1,3 @@
 """Single source of truth for the devopsos package version."""
 
-__version__ = "0.3.0"
+__version__ = "0.4.0"

cli/devopsos.py

@@ -15,6 +15,7 @@
 import cli.scaffold_argocd as scaffold_argocd
 import cli.scaffold_sre as scaffold_sre
 import cli.scaffold_devcontainer as scaffold_devcontainer
+import cli.scaffold_unittest as scaffold_unittest
 import cli.process_first as process_first
 from cli import __version__
 
@@ -559,6 +560,74 @@ def scaffold_cicd_cmd(
         flags += ["--custom-values", custom_values]
     _run_scaffold(scaffold_cicd.main, flags)
 
+
+# ── scaffold unittest ────────────────────────────────────────────────────────
+
+@scaffold_app.command("unittest")
+def scaffold_unittest_cmd(
+    ctx: typer.Context,
+    name: str = typer.Option("my-app", envvar="DEVOPS_OS_UNITTEST_NAME",
+                              help="Project / application name"),
+    languages: str = typer.Option("python", envvar="DEVOPS_OS_UNITTEST_LANGUAGES",
+                                   help=(
+                                       "Comma-separated languages to generate tests for: "
+                                       "python, javascript, typescript, go"
+                                   )),
+    framework: str = typer.Option("", envvar="DEVOPS_OS_UNITTEST_FRAMEWORK",
+                                   help=(
+                                       "Testing framework override (auto-selected by default). "
+                                       "JS/TS: jest | mocha | vitest. Python: pytest. Go: go-test."
+                                   )),
+    coverage: bool = typer.Option(True, envvar="DEVOPS_OS_UNITTEST_COVERAGE",
+                                   help="Include coverage configuration (default: true)"),
+    output_dir: str = typer.Option("unittest", "--output-dir",
+                                    envvar="DEVOPS_OS_UNITTEST_OUTPUT_DIR",
+                                    help="Root output directory for generated files"),
+):
+    """Generate unit testing configuration and sample test files.
+
+    \b
+    Supported languages and their default frameworks:
+      python       → pytest + pytest-cov
+      javascript   → Jest (override with --framework mocha | vitest)
+      typescript   → Jest (override with --framework mocha | vitest)
+      go           → go test
+
+    \b
+    Output files (default: unittest/ directory):
+      unittest/pytest.ini              Python pytest configuration
+      unittest/conftest.py             Python shared fixtures
+      unittest/tests/__init__.py       Python test-package marker
+      unittest/tests/test_sample.py    Python sample unit tests
+      unittest/jest.config.js          JavaScript/TypeScript Jest config
+      unittest/vitest.config.js        JavaScript/TypeScript Vitest config
+      unittest/.mocharc.js             JavaScript/TypeScript Mocha config
+      unittest/tests/sample.test.js    JavaScript/TypeScript sample tests
+      unittest/<name>_test.go          Go sample unit test file
+      unittest/Makefile.test           Go Makefile test targets
+
+    \b
+    Examples:
+      devopsos scaffold unittest --name my-app --languages python
+      devopsos scaffold unittest --name my-app --languages javascript --framework jest
+      devopsos scaffold unittest --name my-app --languages typescript --framework vitest
+      devopsos scaffold unittest --name my-api --languages go
+      devopsos scaffold unittest --name my-app --languages python,javascript,go
+    """
+    _show_help_if_no_opts(ctx)
+    flags = [
+        "--name", name,
+        "--languages", languages,
+        "--output-dir", output_dir,
+    ]
+    if framework:
+        flags += ["--framework", framework]
+    if not coverage:
+        # coverage defaults to True; only pass flag when False
+        flags.append("--no-coverage")
+    _run_scaffold(scaffold_unittest.main, flags)
+
+
 @app.command()
 def init(
     directory: str = typer.Option(".", "--dir", help="Target directory in which the .devcontainer folder will be created (defaults to the current directory)"),