fix: add HOW TO USE footer to process-first default output

When users run `python -m cli.devopsos process-first` with no arguments
they now see a HOW TO USE THIS COMMAND footer at the end of the output,
showing every --section option and the --help flag inline. The footer
only appears on the default 'all' output; focused --section invocations
remain uncluttered.

- cli/process_first.py: USAGE_FOOTER constant appended to 'all' section
- cli/test_cli.py: two new tests (footer present on default, absent on
  specific sections)

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

Author: Copilot

cli/process_first.py

@@ -139,6 +139,25 @@
 
 """
 
+USAGE_FOOTER = """\
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  HOW TO USE THIS COMMAND
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+  python -m cli.devopsos process-first                     # full overview (this output)
+  python -m cli.devopsos process-first --section what      # 5 core principles only
+  python -m cli.devopsos process-first --section mapping   # devopsos scaffold command map
+  python -m cli.devopsos process-first --section tips      # AI prompts for beginners
+  python -m cli.devopsos process-first --help              # full option reference
+
+  You can also run the standalone module:
+
+  python -m cli.process_first [--section what|mapping|tips|all]
+
+  📖  Full docs: docs/PROCESS-FIRST.md
+
+"""
+
 FULL_TEXT = (
     PROCESS_FIRST_SUMMARY
     + WHAT_IS_PROCESS_FIRST
@@ -155,7 +174,7 @@
     "what": PROCESS_FIRST_SUMMARY + WHAT_IS_PROCESS_FIRST,
     "mapping": PROCESS_FIRST_SUMMARY + MAPPING_TO_TOOLING,
     "tips": PROCESS_FIRST_SUMMARY + BEGINNER_TIPS,
-    "all": FULL_TEXT,
+    "all": FULL_TEXT + USAGE_FOOTER,
 }
 
 

cli/test_cli.py

@@ -369,3 +369,24 @@ def test_process_first_invalid_section_clean_error():
     assert "ValueError" not in combined, "Expected clean CLI error, not a ValueError"
     assert "is not one of" in combined or "Invalid value" in combined
 
+
+def test_process_first_default_output_includes_usage_footer():
+    """Default output (no --section) includes a HOW TO USE footer with section examples."""
+    result = _run(["-m", "cli.devopsos", "process-first"])
+    assert result.returncode == 0
+    assert "HOW TO USE THIS COMMAND" in result.stdout
+    assert "--section what" in result.stdout
+    assert "--section mapping" in result.stdout
+    assert "--section tips" in result.stdout
+    assert "--help" in result.stdout
+
+
+def test_process_first_specific_section_no_usage_footer():
+    """Specific sections (not 'all') do NOT include the usage footer."""
+    for section in ("what", "mapping", "tips"):
+        result = _run(["-m", "cli.devopsos", "process-first", "--section", section])
+        assert result.returncode == 0
+        assert "HOW TO USE THIS COMMAND" not in result.stdout, (
+            f"--section {section} should not show the usage footer"
+        )
+