docs: enhance CLI help system for AI agents and users

Improved guardian --help with comprehensive, actionable information:
- Add DETECTS section with quick fix instructions for all 8 violation types
- Add SEVERITY LEVELS explanation (CRITICAL → LOW)
- Add step-by-step WORKFLOW guide
- Add 7 practical EXAMPLES covering common use cases
- Add HOW TO FIX COMMON ISSUES reference section

Technical improvements:
- Extract all help text strings to CLI_HELP_TEXT constants
- Fix 17 hardcoded string violations
- Maintain Single Source of Truth principle
- Zero violations in Guardian's own codebase

The help system now provides complete context for autonomous AI agents
and clear guidance for human developers.

packages/guardian/src/cli/index.ts

@@ -6,6 +6,7 @@ import {
     CLI_ARGUMENTS,
     CLI_COMMANDS,
     CLI_DESCRIPTIONS,
+    CLI_HELP_TEXT,
     CLI_LABELS,
     CLI_MESSAGES,
     CLI_OPTIONS,
@@ -99,7 +100,30 @@ function displayGroupedViolations<T extends { severity: SeverityLevel }>(
 
 const program = new Command()
 
-program.name(CLI_COMMANDS.NAME).description(CLI_DESCRIPTIONS.MAIN).version(version)
+program
+    .name(CLI_COMMANDS.NAME)
+    .description(CLI_DESCRIPTIONS.MAIN)
+    .version(version)
+    .addHelpText(
+        CLI_HELP_TEXT.POSITION,
+        CLI_HELP_TEXT.EXAMPLES_HEADER +
+            CLI_HELP_TEXT.EXAMPLE_BASIC +
+            CLI_HELP_TEXT.EXAMPLE_CRITICAL +
+            CLI_HELP_TEXT.EXAMPLE_SEVERITY +
+            CLI_HELP_TEXT.EXAMPLE_LIMIT +
+            CLI_HELP_TEXT.EXAMPLE_NO_HARDCODE +
+            CLI_HELP_TEXT.EXAMPLE_NO_ARCHITECTURE +
+            CLI_HELP_TEXT.EXAMPLE_EXCLUDE +
+            CLI_HELP_TEXT.FIX_HEADER +
+            CLI_HELP_TEXT.FIX_HARDCODE +
+            CLI_HELP_TEXT.FIX_CIRCULAR +
+            CLI_HELP_TEXT.FIX_FRAMEWORK +
+            CLI_HELP_TEXT.FIX_NAMING +
+            CLI_HELP_TEXT.FIX_ENTITY +
+            CLI_HELP_TEXT.FIX_DEPENDENCY +
+            CLI_HELP_TEXT.FIX_REPOSITORY +
+            CLI_HELP_TEXT.FOOTER,
+    )
 
 program
     .command(CLI_COMMANDS.CHECK)