Feature: Add CLI list-templates Command #31

Adds new Feature: Add CLI list-templates Command #31

Author: IvantheGreatMaker

cli/devopsos.py

@@ -877,5 +877,44 @@ def process_first_cmd(
     process_first.display(section.value)
 
 
+# List of scaffold modules for dynamic template discovery
+_SCAFFOLD_MODULES = [
+    scaffold_gha,
+    scaffold_gitlab,
+    scaffold_jenkins,
+    scaffold_cicd,
+    scaffold_argocd,
+    scaffold_sre,
+    scaffold_unittest,
+    scaffold_devcontainer,
+]
+
+
+def _collect_templates():
+    """Collect TEMPLATE_INFO from all scaffold modules, grouped by category."""
+    by_category = {}
+    for mod in _SCAFFOLD_MODULES:
+        info = getattr(mod, "TEMPLATE_INFO", None)
+        if info:
+            cat = info.get("category", "Other")
+            by_category.setdefault(cat, []).append(info)
+    return by_category
+
+
+@app.command("list")
+def list_templates():
+    """List all available scaffold templates organized by category."""
+    templates = _collect_templates()
+    typer.echo("\nAvailable Templates:\n")
+    for category, items in templates.items():
+        typer.echo(typer.style(category, bold=True))
+        for t in items:
+            name = t["name"].ljust(14)
+            desc = t["description"]
+            typer.echo(f"  {name} {desc}")
+        typer.echo()
+    typer.echo("Run 'python -m cli.devopsos scaffold --help' for usage details.\n")
+
+
 if __name__ == "__main__":
     app()

cli/scaffold_argocd.py

@@ -16,6 +16,12 @@
   └── image-update-automation.yaml Flux image update automation
 """
 
+TEMPLATE_INFO = {
+    "name": "argocd",
+    "category": "GitOps",
+    "description": "ArgoCD/Flux manifests",
+}
+
 import os
 import argparse
 import yaml

cli/scaffold_cicd.py

@@ -11,6 +11,12 @@
     python -m cli.devopsos scaffold cicd [options]
 """
 
+TEMPLATE_INFO = {
+    "name": "cicd",
+    "category": "CI/CD",
+    "description": "Combined CI/CD (GHA + Jenkins)",
+}
+
 import os
 import sys
 import argparse

cli/scaffold_devcontainer.py

@@ -13,6 +13,12 @@
   └── devcontainer.env.json    Tool / language selection & versions
 """
 
+TEMPLATE_INFO = {
+    "name": "devcontainer",
+    "category": "Development",
+    "description": "VS Code dev containers",
+}
+
 import os
 import argparse
 import json

cli/scaffold_gha.py

@@ -15,6 +15,12 @@
 - Matrix build support for multiple OS/architectures
 """
 
+TEMPLATE_INFO = {
+    "name": "gha",
+    "category": "CI/CD",
+    "description": "GitHub Actions workflows",
+}
+
 import os
 import sys
 import argparse

cli/scaffold_gitlab.py

@@ -14,6 +14,12 @@
 - Merge request pipelines and branch protection
 """
 
+TEMPLATE_INFO = {
+    "name": "gitlab",
+    "category": "CI/CD",
+    "description": "GitLab CI pipelines",
+}
+
 import os
 import sys
 import argparse

cli/scaffold_jenkins.py

@@ -15,6 +15,12 @@
 - Support for various source control management (SCM) systems
 """
 
+TEMPLATE_INFO = {
+    "name": "jenkins",
+    "category": "CI/CD",
+    "description": "Jenkins pipelines",
+}
+
 import os
 import sys
 import argparse

cli/scaffold_sre.py

@@ -16,6 +16,12 @@
   └── alertmanager-config.yaml Alertmanager receiver config stub
 """
 
+TEMPLATE_INFO = {
+    "name": "sre",
+    "category": "SRE",
+    "description": "Prometheus alerts, Grafana dashboards, SLOs",
+}
+
 import os
 import argparse
 import json

cli/scaffold_unittest.py

@@ -26,6 +26,12 @@
   └── sample_test.go          # Go — sample unit test file
 """
 
+TEMPLATE_INFO = {
+    "name": "unittest",
+    "category": "Testing",
+    "description": "Unit test configs (pytest, Jest, Go)",
+}
+
 import os
 import sys
 import argparse

cli/test_cli.py

@@ -24,6 +24,28 @@ def _strip_ansi(s):
 
 # -- devopsos CLI ----------------------------------------------------------
 
+def test_list_command():
+    """Test that list command shows all templates grouped by category."""
+    result = _run_module("cli.devopsos", ["list"])
+    assert result.returncode == 0
+    out = _strip_ansi(result.stdout)
+    assert "CI/CD" in out
+    assert "GitOps" in out
+    assert "SRE" in out
+    assert "Testing" in out
+    assert "Development" in out
+    assert "gha" in out
+    assert "jenkins" in out
+    assert "argocd" in out
+
+
+def test_list_in_help():
+    """Test that list appears in main help."""
+    result = _run_module("cli.devopsos", ["--help"])
+    assert result.returncode == 0
+    assert "list" in result.stdout
+
+
 def test_help():
     result = _run(["-m", "cli.devopsos", "--help"])
     assert result.returncode == 0