logicstamp-context 0.8.2 → 0.8.4

package/dist/cli/parser/helpText.js

@@ -2,603 +2,603 @@
  * Help text for CLI commands
  */
 export function getMainHelp() {
-    return `
-╭─────────────────────────────────────────────────╮
-│  Stamp - The Context Compiler for TypeScript    │
-│  Compile code into deterministic contracts      │
-╰─────────────────────────────────────────────────╯
-
-USAGE:
-  stamp init [path]                    Initialize LogicStamp in a project
-  stamp context [path] [options]       Compile context
-  stamp context style [path] [options] Compile context with style metadata
-  stamp context validate [file]        Validate context file
-  stamp context compare [options]      Detect drift (auto-compiles fresh context)
-  stamp context clean [path] [options] Remove all compiled context artifacts
-  stamp ignore <path> [path2] ...      Add files/folders to .stampignore
-  stamp security scan [path] [options] Scan for secrets and compile report
-  stamp security --hard-reset [options] Delete security report
-
-OPTIONS:
-  -v, --version                       Show version number
-  -h, --help                          Show this help
-
-EXAMPLES:
-  stamp init
-    Set up LogicStamp in current directory (creates/updates .gitignore)
-
-  stamp context
-    Compile context.json for current directory
-
-  stamp context style
-    Compile context with style metadata (Tailwind, SCSS, animations, layout)
-
-  stamp context --include-style
-    Same as 'stamp context style' (alternative syntax)
-
-  stamp context validate
-    Validate context.json in current directory
-
-  stamp context compare
-    Auto-detect drift by comparing with fresh context
-
-  stamp context clean
-    Show what would be removed (dry run)
-
-  stamp context clean --all --yes
-    Actually delete all context artifacts
-
-  stamp ignore src/secrets.ts
-    Add a file to .stampignore
-
-For detailed help on a specific command, run:
-  stamp init --help
-  stamp context --help
-  stamp context style --help
-  stamp context validate --help
-  stamp context compare --help
-  stamp context clean --help
-  stamp ignore --help
-  stamp security scan --help
-  stamp security --help
+    return `
+╭─────────────────────────────────────────────────╮
+│  Stamp - The Context Compiler for TypeScript    │
+│  Compile code into deterministic contracts      │
+╰─────────────────────────────────────────────────╯
+
+USAGE:
+  stamp init [path]                    Initialize LogicStamp in a project
+  stamp context [path] [options]       Compile context
+  stamp context style [path] [options] Compile context with style metadata
+  stamp context validate [file]        Validate context file
+  stamp context compare [options]      Detect drift (auto-compiles fresh context)
+  stamp context clean [path] [options] Remove all compiled context artifacts
+  stamp ignore <path> [path2] ...      Add files/folders to .stampignore
+  stamp security scan [path] [options] Scan for secrets and compile report
+  stamp security --hard-reset [options] Delete security report
+
+OPTIONS:
+  -v, --version                       Show version number
+  -h, --help                          Show this help
+
+EXAMPLES:
+  stamp init
+    Set up LogicStamp in current directory (creates/updates .gitignore)
+
+  stamp context
+    Compile context.json for current directory
+
+  stamp context style
+    Compile context with style metadata (Tailwind, SCSS, animations, layout)
+
+  stamp context --include-style
+    Same as 'stamp context style' (alternative syntax)
+
+  stamp context validate
+    Validate context.json in current directory
+
+  stamp context compare
+    Auto-detect drift by comparing with fresh context
+
+  stamp context clean
+    Show what would be removed (dry run)
+
+  stamp context clean --all --yes
+    Actually delete all context artifacts
+
+  stamp ignore src/secrets.ts
+    Add a file to .stampignore
+
+For detailed help on a specific command, run:
+  stamp init --help
+  stamp context --help
+  stamp context style --help
+  stamp context validate --help
+  stamp context compare --help
+  stamp context clean --help
+  stamp ignore --help
+  stamp security scan --help
+  stamp security --help
   `;
 }
 export function getSecurityHelp() {
-    return `
-╭─────────────────────────────────────────────────╮
-│  Stamp Security - Security Management          │
-│  Manage security scans and configuration       │
-╰─────────────────────────────────────────────────╯
-
-USAGE:
-  stamp security scan [path] [options]       Scan for secrets and compile report
-  stamp security --hard-reset [path] [options] Delete security report
-
-COMMANDS:
-  scan                                    Scan codebase for exposed secrets
-  --hard-reset                            Delete security report file
-  --hard-reset --force                    Delete report file without prompting
-
-OPTIONS:
-  --out, -o <file>                        Output file for scan (default: stamp_security_report.json)
-  --force                                 Skip confirmation prompt (use with --hard-reset)
-  --quiet, -q                            Suppress verbose output
-  -h, --help                             Show this help
-
-EXAMPLES:
-  stamp security scan
-    Scan current directory for secrets
-
-  stamp security scan ./src
-    Scan specific directory
-
-  stamp security --hard-reset
-    Delete security report (with confirmation)
-
-  stamp security --hard-reset --force
-    Delete security report (no confirmation)
-
-  stamp security --hard-reset --out custom-report.json
-    Delete custom report file
-
-For detailed help on scan command:
-  stamp security scan --help
+    return `
+╭─────────────────────────────────────────────────╮
+│  Stamp Security - Security Management          │
+│  Manage security scans and configuration       │
+╰─────────────────────────────────────────────────╯
+
+USAGE:
+  stamp security scan [path] [options]       Scan for secrets and compile report
+  stamp security --hard-reset [path] [options] Delete security report
+
+COMMANDS:
+  scan                                    Scan codebase for exposed secrets
+  --hard-reset                            Delete security report file
+  --hard-reset --force                    Delete report file without prompting
+
+OPTIONS:
+  --out, -o <file>                        Output file for scan (default: stamp_security_report.json)
+  --force                                 Skip confirmation prompt (use with --hard-reset)
+  --quiet, -q                            Suppress verbose output
+  -h, --help                             Show this help
+
+EXAMPLES:
+  stamp security scan
+    Scan current directory for secrets
+
+  stamp security scan ./src
+    Scan specific directory
+
+  stamp security --hard-reset
+    Delete security report (with confirmation)
+
+  stamp security --hard-reset --force
+    Delete security report (no confirmation)
+
+  stamp security --hard-reset --out custom-report.json
+    Delete custom report file
+
+For detailed help on scan command:
+  stamp security scan --help
   `;
 }
 export function getStyleHelp() {
-    return `
-╭─────────────────────────────────────────────────╮
-│  Stamp Context Style - Compile with Style       │
-│  Compile context with style metadata           │
-│  (Tailwind, SCSS, animations, layout)           │
-╰─────────────────────────────────────────────────╯
-
-USAGE:
-  stamp context style [path] [options]
-
-ARGUMENTS:
-  [path]                              Directory to scan (default: current)
-
-OPTIONS:
-  --style-mode <mode>                 Style output: lean|full (default: lean)
-                                      lean: counts + flags (compact)
-                                      full: arrays + details (verbose)
-  --depth, -d <n>                     Dependency depth (default: 2)
-  --include-code, -c <mode>           Code inclusion: none|header|full (default: header)
-  --format, -f <format>                Output format: json|pretty|ndjson|toon (default: json)
-  --out, -o <file>                    Output file (default: context.json)
-  --max-nodes, -m <n>                 Max nodes per bundle (default: 100)
-  --profile <profile>                 Preset profile: llm-safe|llm-chat|ci-strict|watch-fast
-                                      watch-fast: Fast watch mode (lighter style extraction)
-  --strict, -s                        Fail on missing dependencies
-  --strict-missing                    Exit with error if any missing dependencies
-  --predict-behavior                  Include behavior predictions
-  --dry-run                           Skip writing output
-  --stats                             Emit JSON stats
-  --compare-modes                     Show detailed mode comparison table
-  --skip-gitignore                    Skip .gitignore setup (never prompt or modify)
-  --quiet, -q                         Suppress verbose output (show only errors)
-  --verbose                            Show detailed bundle output (checkmarks for each file)
-  --watch, -w                         Watch for file changes and recompile automatically
-                                      Tip: Pass a subdirectory path to watch only that folder
-  --strict-watch                      Enable strict watch mode - automatically enables watch
-                                      mode and tracks breaking changes and violations.
-                                      Exits with code 1 if errors detected. Reports saved
-                                      to .logicstamp/
-  --debug                             Show detailed hash information in watch mode
-  -h, --help                          Show this help
-
-STYLE METADATA EXTRACTED:
-  • Styling Sources: Tailwind, SCSS modules, CSS modules, inline styles, styled-components
-  • Layout: Flex/grid patterns, hero sections, feature cards
-  • Visual: Colors, spacing, typography, border radius
-  • Animation: Framer Motion, CSS animations, scroll triggers
-
-EXAMPLES:
-  stamp context style
-    Compile context with style metadata for current directory
-
-  stamp context style ./src
-    Compile with style metadata for src directory
-
-  stamp context style --profile llm-safe
-    Use conservative profile with style metadata
-
-  stamp context style --watch
-    Watch for file changes and recompile with style metadata
-
-  stamp context style --watch --debug
-    Watch mode with detailed hash information
-
-  stamp context style ./src/components/MyFeature --watch
-    Watch only files in a specific subdirectory (incremental rebuilds are fast!)
-
-  stamp context style --strict-watch
-    Watch mode with violation tracking for breaking changes
-    (Equivalent to: stamp context style --watch --strict-watch)
-
-NOTES:
-  • This is equivalent to: stamp context --include-style
-  • Style extraction is optional and won't fail the build if errors occur
-  • Style metadata is added to the 'style' field in UIFContract
+    return `
+╭─────────────────────────────────────────────────╮
+│  Stamp Context Style - Compile with Style       │
+│  Compile context with style metadata           │
+│  (Tailwind, SCSS, animations, layout)           │
+╰─────────────────────────────────────────────────╯
+
+USAGE:
+  stamp context style [path] [options]
+
+ARGUMENTS:
+  [path]                              Directory to scan (default: current)
+
+OPTIONS:
+  --style-mode <mode>                 Style output: lean|full (default: lean)
+                                      lean: counts + flags (compact)
+                                      full: arrays + details (verbose)
+  --depth, -d <n>                     Dependency depth (default: 2)
+  --include-code, -c <mode>           Code inclusion: none|header|full (default: header)
+  --format, -f <format>                Output format: json|pretty|ndjson|toon (default: json)
+  --out, -o <file>                    Output file (default: context.json)
+  --max-nodes, -m <n>                 Max nodes per bundle (default: 100)
+  --profile <profile>                 Preset profile: llm-safe|llm-chat|ci-strict|watch-fast
+                                      watch-fast: Fast watch mode (lighter style extraction)
+  --strict, -s                        Fail on missing dependencies
+  --strict-missing                    Exit with error if any missing dependencies
+  --predict-behavior                  Include behavior predictions
+  --dry-run                           Skip writing output
+  --stats                             Emit JSON stats
+  --compare-modes                     Show detailed mode comparison table
+  --skip-gitignore                    Skip .gitignore setup (never prompt or modify)
+  --quiet, -q                         Suppress verbose output (show only errors)
+  --verbose                            Show detailed bundle output (checkmarks for each file)
+  --watch, -w                         Watch for file changes and recompile automatically
+                                      Tip: Pass a subdirectory path to watch only that folder
+  --strict-watch                      Enable strict watch mode - automatically enables watch
+                                      mode and tracks breaking changes and violations.
+                                      Exits with code 1 if errors detected. Reports saved
+                                      to .logicstamp/
+  --debug                             Show detailed hash information in watch mode
+  -h, --help                          Show this help
+
+STYLE METADATA EXTRACTED:
+  • Styling Sources: Tailwind, SCSS modules, CSS modules, inline styles, styled-components
+  • Layout: Flex/grid patterns, hero sections, feature cards
+  • Visual: Colors, spacing, typography, border radius
+  • Animation: Framer Motion, CSS animations, scroll triggers
+
+EXAMPLES:
+  stamp context style
+    Compile context with style metadata for current directory
+
+  stamp context style ./src
+    Compile with style metadata for src directory
+
+  stamp context style --profile llm-safe
+    Use conservative profile with style metadata
+
+  stamp context style --watch
+    Watch for file changes and recompile with style metadata
+
+  stamp context style --watch --debug
+    Watch mode with detailed hash information
+
+  stamp context style ./src/components/MyFeature --watch
+    Watch only files in a specific subdirectory (incremental rebuilds are fast!)
+
+  stamp context style --strict-watch
+    Watch mode with violation tracking for breaking changes
+    (Equivalent to: stamp context style --watch --strict-watch)
+
+NOTES:
+  • This is equivalent to: stamp context --include-style
+  • Style extraction is optional and won't fail the build if errors occur
+  • Style metadata is added to the 'style' field in UIFContract
   `;
 }
 export function getGenerateHelp() {
-    return `
-╭─────────────────────────────────────────────────╮
-│  Stamp Context - Compile Architectural Context  │
-│  Deterministic contracts from TypeScript        │
-╰─────────────────────────────────────────────────╯
-
-USAGE:
-  stamp context [path] [options]
-
-ARGUMENTS:
-  [path]                              Directory to scan (default: current)
-
-OPTIONS:
-  --depth, -d <n>                     Dependency depth (default: 2)
-  --include-code, -c <mode>           Code inclusion: none|header|full (default: header)
-  --include-style                     Extract style metadata (Tailwind, SCSS, animations, layout)
-  --style-mode <mode>                 Style output: lean|full (default: lean)
-                                      lean: counts + flags (compact)
-                                      full: arrays + details (verbose)
-  --format, -f <format>               Output format: json|pretty|ndjson|toon (default: json)
-  --out, -o <file>                    Output file (default: context.json)
-  --max-nodes, -m <n>                 Max nodes per bundle (default: 100)
-  --profile <profile>                 Preset profile: llm-safe|llm-chat|ci-strict|watch-fast
-                                      watch-fast: Fast watch mode (lighter style extraction)
-  --strict, -s                        Fail on missing dependencies
-  --strict-missing                    Exit with error if any missing dependencies
-  --predict-behavior                  Include behavior predictions
-  --dry-run                           Skip writing output
-  --stats                             Emit JSON stats
-  --compare-modes                     Show detailed mode comparison table
-  --skip-gitignore                    Skip .gitignore setup (never prompt or modify)
-  --quiet, -q                         Suppress verbose output (show only errors)
-  --verbose                            Show detailed bundle output (checkmarks for each file)
-  --watch, -w                         Watch for file changes and recompile automatically
-  --strict-watch                      Enable strict watch mode - automatically enables watch
-                                      mode and tracks breaking changes and violations.
-                                      Exits with code 1 if errors detected. Reports saved
-                                      to .logicstamp/
-  --debug                             Show detailed hash information in watch mode
-  -h, --help                          Show this help
-
-EXAMPLES:
-  stamp context
-    Compile context for current directory
-
-  stamp context style
-    Compile context with style metadata (Tailwind, SCSS, animations, layout)
-
-  stamp context --include-style
-    Alternative syntax for including style metadata
-
-  stamp context ./src --depth 2
-    Compile src directory with depth 2
-
-  stamp context --include-code none --out api.json
-    Compile contracts only (no code)
-
-  stamp context --compare-modes
-    Show token cost comparison across modes
-
-  stamp context --watch
-    Watch for file changes and recompile automatically
-
-  stamp context --watch --debug
-    Watch mode with detailed hash information
-
-  stamp context ./src/components/MyFeature --watch
-    Watch only files in a specific subdirectory (incremental recompilation)
-
-  stamp context --strict-watch
-    Watch mode with violation tracking - reports breaking changes
-    (removed props, events, functions) and missing dependencies.
-    Exits with code 1 if errors detected during session.
-    (Equivalent to: stamp context --watch --strict-watch)
-
-  stamp context --quiet
-    Suppress verbose output (show only errors)
+    return `
+╭─────────────────────────────────────────────────╮
+│  Stamp Context - Compile Architectural Context  │
+│  Deterministic contracts from TypeScript        │
+╰─────────────────────────────────────────────────╯
+
+USAGE:
+  stamp context [path] [options]
+
+ARGUMENTS:
+  [path]                              Directory to scan (default: current)
+
+OPTIONS:
+  --depth, -d <n>                     Dependency depth (default: 2)
+  --include-code, -c <mode>           Code inclusion: none|header|full (default: header)
+  --include-style                     Extract style metadata (Tailwind, SCSS, animations, layout)
+  --style-mode <mode>                 Style output: lean|full (default: lean)
+                                      lean: counts + flags (compact)
+                                      full: arrays + details (verbose)
+  --format, -f <format>               Output format: json|pretty|ndjson|toon (default: json)
+  --out, -o <file>                    Output file (default: context.json)
+  --max-nodes, -m <n>                 Max nodes per bundle (default: 100)
+  --profile <profile>                 Preset profile: llm-safe|llm-chat|ci-strict|watch-fast
+                                      watch-fast: Fast watch mode (lighter style extraction)
+  --strict, -s                        Fail on missing dependencies
+  --strict-missing                    Exit with error if any missing dependencies
+  --predict-behavior                  Include behavior predictions
+  --dry-run                           Skip writing output
+  --stats                             Emit JSON stats
+  --compare-modes                     Show detailed mode comparison table
+  --skip-gitignore                    Skip .gitignore setup (never prompt or modify)
+  --quiet, -q                         Suppress verbose output (show only errors)
+  --verbose                            Show detailed bundle output (checkmarks for each file)
+  --watch, -w                         Watch for file changes and recompile automatically
+  --strict-watch                      Enable strict watch mode - automatically enables watch
+                                      mode and tracks breaking changes and violations.
+                                      Exits with code 1 if errors detected. Reports saved
+                                      to .logicstamp/
+  --debug                             Show detailed hash information in watch mode
+  -h, --help                          Show this help
+
+EXAMPLES:
+  stamp context
+    Compile context for current directory
+
+  stamp context style
+    Compile context with style metadata (Tailwind, SCSS, animations, layout)
+
+  stamp context --include-style
+    Alternative syntax for including style metadata
+
+  stamp context ./src --depth 2
+    Compile src directory with depth 2
+
+  stamp context --include-code none --out api.json
+    Compile contracts only (no code)
+
+  stamp context --compare-modes
+    Show token cost comparison across modes
+
+  stamp context --watch
+    Watch for file changes and recompile automatically
+
+  stamp context --watch --debug
+    Watch mode with detailed hash information
+
+  stamp context ./src/components/MyFeature --watch
+    Watch only files in a specific subdirectory (incremental recompilation)
+
+  stamp context --strict-watch
+    Watch mode with violation tracking - reports breaking changes
+    (removed props, events, functions) and missing dependencies.
+    Exits with code 1 if errors detected during session.
+    (Equivalent to: stamp context --watch --strict-watch)
+
+  stamp context --quiet
+    Suppress verbose output (show only errors)
   `;
 }
 export function getValidateHelp() {
-    return `
-╭─────────────────────────────────────────────────╮
-│  Stamp Context Validate - Bundle Validator      │
-│  Validate context.json structure and schema     │
-╰─────────────────────────────────────────────────╯
-
-USAGE:
-  stamp context validate [file]
-
-ARGUMENTS:
-  [file]                              Path to context.json (default: context.json)
-
-OPTIONS:
-  --quiet                             Show only errors (suppress summaries and valid folders)
-  -h, --help                          Show this help
-
-EXAMPLES:
-  stamp context validate
-    Validate context.json in current directory
-
-  stamp context validate docs/api-context.json
-    Validate a specific context file
-
-  stamp context validate --quiet
-    Show only validation errors
-
-NOTES:
-  • Validates bundle structure and schema compliance
-  • Checks for required fields and hash formats
-  • Exits with code 0 on success, 1 on failure
+    return `
+╭─────────────────────────────────────────────────╮
+│  Stamp Context Validate - Bundle Validator      │
+│  Validate context.json structure and schema     │
+╰─────────────────────────────────────────────────╯
+
+USAGE:
+  stamp context validate [file]
+
+ARGUMENTS:
+  [file]                              Path to context.json (default: context.json)
+
+OPTIONS:
+  --quiet                             Show only errors (suppress summaries and valid folders)
+  -h, --help                          Show this help
+
+EXAMPLES:
+  stamp context validate
+    Validate context.json in current directory
+
+  stamp context validate docs/api-context.json
+    Validate a specific context file
+
+  stamp context validate --quiet
+    Show only validation errors
+
+NOTES:
+  • Validates bundle structure and schema compliance
+  • Checks for required fields and hash formats
+  • Exits with code 0 on success, 1 on failure
   `;
 }
 export function getCompareHelp() {
-    return `
-╭─────────────────────────────────────────────────╮
-│  Stamp Context Compare - Drift Detection        │
-│  Compare context files for changes              │
-╰─────────────────────────────────────────────────╯
-
-USAGE:
-  stamp context compare [options]                     Auto-compare all context files
-  stamp context compare <old.json> <new.json>         Compare two specific files
-  stamp context compare <old_main.json> <new_main.json>  Compare multi-file indices
-
-ARGUMENTS:
-  <old.json>                          Path to old context file or context_main.json
-  <new.json>                          Path to new context file or context_main.json
-
-OPTIONS:
-  --baseline <ref>                    Compare against a git ref (e.g., git:main, git:HEAD, git:v1.0.0)
-  --approve                           Auto-approve updates (non-interactive, CI-safe)
-  --clean-orphaned                    Auto-delete orphaned files with --approve
-  --stats                             Show token count statistics per folder
-  --strict                            Detect breaking changes (removed props, events, functions)
-                                      and exit with code 1 if errors found
-  --skip-gitignore                    Skip .gitignore setup when compiling fresh context (auto-mode only)
-  --quiet                             Show only diffs (suppress summaries, PASS folders, and token analysis)
-  -h, --help                          Show this help
-
-COMPARISON MODES:
-  Auto-Mode (Multi-File):
-    Compares ALL context files using context_main.json as index
-    → Detects ADDED, ORPHANED, DRIFT, and PASS status per folder
-    → Shows three-tier output: folder summary, component summary, details
-
-  Git Baseline Mode:
-    Compare current working tree against a git ref (branch, tag, commit)
-    → Uses git worktree to checkout ref in isolation
-    → Generates context for both versions and compares
-    → Useful for PR reviews, CI validation, and release checks
-
-  Single-File Mode:
-    Compares two individual context.json files
-    → Detects added/removed/changed components
-
-  Multi-File Manual Mode:
-    Auto-detects when comparing context_main.json files
-    → Compares all referenced context files
-
-EXAMPLES:
-  stamp context compare
-    Auto-mode: compile fresh context, compare ALL files
-    → Shows folder-level and component-level changes
-    → Interactive: prompts Y/N to update if drift detected
-    → CI: exits with code 1 if drift detected (no prompt)
-
-  stamp context compare --approve
-    Auto-approve and update ALL context files if drift (like jest -u)
-
-  stamp context compare --approve --clean-orphaned
-    Auto-approve updates and delete orphaned context files
-
-  stamp context compare --stats
-    Show per-folder token count deltas
-
-  stamp context compare --quiet
-    Show only diffs (suppress summaries, PASS folders, and status headers)
-
-  stamp context compare old.json new.json
-    Compare two specific context files
-
-  stamp context compare old/context_main.json new/context_main.json
-    Compare all context files between two directories
-
-  stamp context compare || exit 1
-    CI validation: fail build if drift detected
-
-  stamp context compare --baseline git:main
-    Compare current working tree against main branch
-    → "What changed in this branch vs main?"
-
-  stamp context compare --baseline git:HEAD
-    Compare uncommitted changes against last commit
-
-  stamp context compare --baseline git:v1.0.0
-    Compare against a release tag
-    → "What changed since last release?"
-
-  stamp context compare --strict
-    Detect breaking changes and fail if errors found
-    → Exit code 1 if removed props, events, or functions detected
-
-  stamp context compare --baseline git:main --strict
-    Compare against main with breaking change detection
-
-EXIT CODES:
-  0                                   PASS - No drift OR drift approved and updated
-  1                                   DRIFT - Changes detected but not approved
-
-BEHAVIOR:
-  • --approve: Non-interactive, deterministic, updates immediately if drift
-  • Interactive (TTY): Prompts "Update all context files? (y/N)" if drift
-  • CI (non-TTY): Never prompts, exits 1 if drift detected
-  • --clean-orphaned: Requires --approve, deletes orphaned files automatically
-  • --quiet: Shows only diffs - suppresses status headers (PASS), summaries, PASS folders, and token analysis
-
-DRIFT INDICATORS:
-  ➕ ADDED FILE         New folder with context file
-  🗑️  ORPHANED FILE     Folder removed (context file still exists)
-  ⚠️  DRIFT             Folder has component changes
-  ✅ PASS               Folder unchanged
-
-NOTES:
-  This matches Jest snapshot workflow:
-    jest          → prompts to update snapshots locally
-    jest -u       → updates snapshots without prompt
-    CI            → fails if snapshots don't match
+    return `
+╭─────────────────────────────────────────────────╮
+│  Stamp Context Compare - Drift Detection        │
+│  Compare context files for changes              │
+╰─────────────────────────────────────────────────╯
+
+USAGE:
+  stamp context compare [options]                     Auto-compare all context files
+  stamp context compare <old.json> <new.json>         Compare two specific files
+  stamp context compare <old_main.json> <new_main.json>  Compare multi-file indices
+
+ARGUMENTS:
+  <old.json>                          Path to old context file or context_main.json
+  <new.json>                          Path to new context file or context_main.json
+
+OPTIONS:
+  --baseline <ref>                    Compare against a git ref (e.g., git:main, git:HEAD, git:v1.0.0)
+  --approve                           Auto-approve updates (non-interactive, CI-safe)
+  --clean-orphaned                    Auto-delete orphaned files with --approve
+  --stats                             Show token count statistics per folder
+  --strict                            Detect breaking changes (removed props, events, functions)
+                                      and exit with code 1 if errors found
+  --skip-gitignore                    Skip .gitignore setup when compiling fresh context (auto-mode only)
+  --quiet                             Show only diffs (suppress summaries, PASS folders, and token analysis)
+  -h, --help                          Show this help
+
+COMPARISON MODES:
+  Auto-Mode (Multi-File):
+    Compares ALL context files using context_main.json as index
+    → Detects ADDED, ORPHANED, DRIFT, and PASS status per folder
+    → Shows three-tier output: folder summary, component summary, details
+
+  Git Baseline Mode:
+    Compare current working tree against a git ref (branch, tag, commit)
+    → Uses git worktree to checkout ref in isolation
+    → Generates context for both versions and compares
+    → Useful for PR reviews, CI validation, and release checks
+
+  Single-File Mode:
+    Compares two individual context.json files
+    → Detects added/removed/changed components
+
+  Multi-File Manual Mode:
+    Auto-detects when comparing context_main.json files
+    → Compares all referenced context files
+
+EXAMPLES:
+  stamp context compare
+    Auto-mode: compile fresh context, compare ALL files
+    → Shows folder-level and component-level changes
+    → Interactive: prompts Y/N to update if drift detected
+    → CI: exits with code 1 if drift detected (no prompt)
+
+  stamp context compare --approve
+    Auto-approve and update ALL context files if drift (like jest -u)
+
+  stamp context compare --approve --clean-orphaned
+    Auto-approve updates and delete orphaned context files
+
+  stamp context compare --stats
+    Show per-folder token count deltas
+
+  stamp context compare --quiet
+    Show only diffs (suppress summaries, PASS folders, and status headers)
+
+  stamp context compare old.json new.json
+    Compare two specific context files
+
+  stamp context compare old/context_main.json new/context_main.json
+    Compare all context files between two directories
+
+  stamp context compare || exit 1
+    CI validation: fail build if drift detected
+
+  stamp context compare --baseline git:main
+    Compare current working tree against main branch
+    → "What changed in this branch vs main?"
+
+  stamp context compare --baseline git:HEAD
+    Compare uncommitted changes against last commit
+
+  stamp context compare --baseline git:v1.0.0
+    Compare against a release tag
+    → "What changed since last release?"
+
+  stamp context compare --strict
+    Detect breaking changes and fail if errors found
+    → Exit code 1 if removed props, events, or functions detected
+
+  stamp context compare --baseline git:main --strict
+    Compare against main with breaking change detection
+
+EXIT CODES:
+  0                                   PASS - No drift OR drift approved and updated
+  1                                   DRIFT - Changes detected but not approved
+
+BEHAVIOR:
+  • --approve: Non-interactive, deterministic, updates immediately if drift
+  • Interactive (TTY): Prompts "Update all context files? (y/N)" if drift
+  • CI (non-TTY): Never prompts, exits 1 if drift detected
+  • --clean-orphaned: Requires --approve, deletes orphaned files automatically
+  • --quiet: Shows only diffs - suppresses status headers (PASS), summaries, PASS folders, and token analysis
+
+DRIFT INDICATORS:
+  ➕ ADDED FILE         New folder with context file
+  🗑️  ORPHANED FILE     Folder removed (context file still exists)
+  ⚠️  DRIFT             Folder has component changes
+  ✅ PASS               Folder unchanged
+
+NOTES:
+  This matches Jest snapshot workflow:
+    jest          → prompts to update snapshots locally
+    jest -u       → updates snapshots without prompt
+    CI            → fails if snapshots don't match
   `;
 }
 export function getCleanHelp() {
-    return `
-╭─────────────────────────────────────────────────╮
-│  Stamp Context Clean - Remove Artifacts        │
-│  Delete all compiled context files             │
-╰─────────────────────────────────────────────────╯
-
-USAGE:
-  stamp context clean [path] [options]
-
-ARGUMENTS:
-  [path]                              Directory to clean (default: current)
-
-OPTIONS:
-  --all                               Include all context files
-  --yes                               Confirm deletion (required with --all)
-  --quiet, -q                         Suppress verbose output (show only errors)
-  -h, --help                          Show this help
-
-BEHAVIOR:
-  • Default (dry run): Shows what would be removed
-  • --all --yes: Actually deletes the files
-  • Automatically includes .logicstamp/ directory if it exists
-  • --quiet: Shows only ✓ on success, errors otherwise
-
-FILES REMOVED:
-  • context_main.json                 Main index file
-  • **/context.json                   All folder context files
-  • **/context.toon                   All folder TOON format bundles
-  • **/context_*.toon                 TOON format variants
-  • .logicstamp/                      Cache directory (if present)
-
-EXAMPLES:
-  stamp context clean
-    Show what would be removed (dry run)
-
-  stamp context clean --all --yes
-    Actually delete all context artifacts (includes .logicstamp/ if present)
-
-  stamp context clean --all --yes --quiet
-    Delete files silently (show only ✓)
-
-  stamp context clean ./src --all --yes
-    Clean context files in specific directory
-
-NOTES:
-  • Safe by default - requires --all --yes to actually delete
-  • Ignores node_modules, dist, build, .next directories
-  • Exits with code 0 on success
+    return `
+╭─────────────────────────────────────────────────╮
+│  Stamp Context Clean - Remove Artifacts        │
+│  Delete all compiled context files             │
+╰─────────────────────────────────────────────────╯
+
+USAGE:
+  stamp context clean [path] [options]
+
+ARGUMENTS:
+  [path]                              Directory to clean (default: current)
+
+OPTIONS:
+  --all                               Include all context files
+  --yes                               Confirm deletion (required with --all)
+  --quiet, -q                         Suppress verbose output (show only errors)
+  -h, --help                          Show this help
+
+BEHAVIOR:
+  • Default (dry run): Shows what would be removed
+  • --all --yes: Actually deletes the files
+  • Automatically includes .logicstamp/ directory if it exists
+  • --quiet: Shows only ✓ on success, errors otherwise
+
+FILES REMOVED:
+  • context_main.json                 Main index file
+  • **/context.json                   All folder context files
+  • **/context.toon                   All folder TOON format bundles
+  • **/context_*.toon                 TOON format variants
+  • .logicstamp/                      Cache directory (if present)
+
+EXAMPLES:
+  stamp context clean
+    Show what would be removed (dry run)
+
+  stamp context clean --all --yes
+    Actually delete all context artifacts (includes .logicstamp/ if present)
+
+  stamp context clean --all --yes --quiet
+    Delete files silently (show only ✓)
+
+  stamp context clean ./src --all --yes
+    Clean context files in specific directory
+
+NOTES:
+  • Safe by default - requires --all --yes to actually delete
+  • Ignores node_modules, dist, build, .next directories
+  • Exits with code 0 on success
   `;
 }
 export function getInitHelp() {
-    return `
-╭─────────────────────────────────────────────────╮
-│  Stamp Init - Initialize LogicStamp            │
-│  Set up LogicStamp in your project              │
-╰─────────────────────────────────────────────────╯
-
-USAGE:
-  stamp init [path] [options]
-
-ARGUMENTS:
-  [path]                              Target directory (default: current)
-
-OPTIONS:
-  --skip-gitignore                    Skip .gitignore setup
-  --yes, -y                           Explicitly skip prompts (non-interactive; default behavior)
-  --no-secure                         Skip security scan (enables interactive prompts in TTY)
-  -h, --help                          Show this help
-
-EXAMPLES:
-  stamp init
-    Set up LogicStamp in current directory (non-interactive, runs security scan by default)
-
-  stamp init ./my-project
-    Set up LogicStamp in a specific directory (non-interactive, runs security scan by default)
-
-  stamp init --skip-gitignore
-    Initialize without modifying .gitignore (security scan still runs)
-
-  stamp init --yes
-    Explicitly skip prompts (redundant - already non-interactive by default)
-
-  stamp init --no-secure
-    Initialize without security scan (enables interactive prompts in TTY mode)
-
-WHAT IT DOES:
-  • Creates or updates .gitignore with LogicStamp patterns:
-    - context.json
-    - context_*.json
-    - context.toon
-    - context_*.toon
-    - *.uif.json
-    - logicstamp.manifest.json
-    - .logicstamp/
-    - stamp_security_report.json
-
-NOTES:
-  • Safe to run multiple times (idempotent)
-  • Won't duplicate patterns if they already exist
-  • Creates .gitignore if it doesn't exist
+    return `
+╭─────────────────────────────────────────────────╮
+│  Stamp Init - Initialize LogicStamp            │
+│  Set up LogicStamp in your project              │
+╰─────────────────────────────────────────────────╯
+
+USAGE:
+  stamp init [path] [options]
+
+ARGUMENTS:
+  [path]                              Target directory (default: current)
+
+OPTIONS:
+  --skip-gitignore                    Skip .gitignore setup
+  --yes, -y                           Explicitly skip prompts (non-interactive; default behavior)
+  --no-secure                         Skip security scan (enables interactive prompts in TTY)
+  -h, --help                          Show this help
+
+EXAMPLES:
+  stamp init
+    Set up LogicStamp in current directory (non-interactive, runs security scan by default)
+
+  stamp init ./my-project
+    Set up LogicStamp in a specific directory (non-interactive, runs security scan by default)
+
+  stamp init --skip-gitignore
+    Initialize without modifying .gitignore (security scan still runs)
+
+  stamp init --yes
+    Explicitly skip prompts (redundant - already non-interactive by default)
+
+  stamp init --no-secure
+    Initialize without security scan (enables interactive prompts in TTY mode)
+
+WHAT IT DOES:
+  • Creates or updates .gitignore with LogicStamp patterns:
+    - context.json
+    - context_*.json
+    - context.toon
+    - context_*.toon
+    - *.uif.json
+    - logicstamp.manifest.json
+    - .logicstamp/
+    - stamp_security_report.json
+
+NOTES:
+  • Safe to run multiple times (idempotent)
+  • Won't duplicate patterns if they already exist
+  • Creates .gitignore if it doesn't exist
   `;
 }
 export function getSecurityScanHelp() {
-    return `
-╭─────────────────────────────────────────────────╮
-│  Stamp Security Scan - Detect Secrets         │
-│  Scan codebase for exposed secrets              │
-╰─────────────────────────────────────────────────╯
-
-USAGE:
-  stamp security scan [path] [options]
-
-ARGUMENTS:
-  [path]                              Directory to scan (default: current)
-
-OPTIONS:
-  --out, -o <file>                    Output file (default: stamp_security_report.json)
-  --quiet, -q                         Suppress verbose output (show only JSON stats)
-  -h, --help                          Show this help
-
-EXAMPLES:
-  stamp security scan
-    Scan current directory for secrets
-
-  stamp security scan ./src
-    Scan specific directory
-
-  stamp security scan --out report.json
-    Write report to custom file
-
-WHAT IT DOES:
-  • Scans TypeScript/JavaScript/JSON files for common secret patterns:
-    - API keys, tokens, passwords
-    - AWS access keys, private keys
-    - OAuth secrets, JWT secrets
-    - Database URLs with credentials
-  • Generates stamp_security_report.json with findings
-
-OUTPUT:
-  • stamp_security_report.json        Detailed report with all findings
-  • Exits with code 1 if secrets found, 0 if clean
-
-NOTES:
-  • Report includes file paths, line numbers, and severity levels
-  • Report file is automatically added to .gitignore to prevent accidental commits
+    return `
+╭─────────────────────────────────────────────────╮
+│  Stamp Security Scan - Detect Secrets         │
+│  Scan codebase for exposed secrets              │
+╰─────────────────────────────────────────────────╯
+
+USAGE:
+  stamp security scan [path] [options]
+
+ARGUMENTS:
+  [path]                              Directory to scan (default: current)
+
+OPTIONS:
+  --out, -o <file>                    Output file (default: stamp_security_report.json)
+  --quiet, -q                         Suppress verbose output (show only JSON stats)
+  -h, --help                          Show this help
+
+EXAMPLES:
+  stamp security scan
+    Scan current directory for secrets
+
+  stamp security scan ./src
+    Scan specific directory
+
+  stamp security scan --out report.json
+    Write report to custom file
+
+WHAT IT DOES:
+  • Scans TypeScript/JavaScript/JSON files for common secret patterns:
+    - API keys, tokens, passwords
+    - AWS access keys, private keys
+    - OAuth secrets, JWT secrets
+    - Database URLs with credentials
+  • Generates stamp_security_report.json with findings
+
+OUTPUT:
+  • stamp_security_report.json        Detailed report with all findings
+  • Exits with code 1 if secrets found, 0 if clean
+
+NOTES:
+  • Report includes file paths, line numbers, and severity levels
+  • Report file is automatically added to .gitignore to prevent accidental commits
   `;
 }
 export function getIgnoreHelp() {
-    return `
-╭─────────────────────────────────────────────────╮
-│  Stamp Ignore - Add Files to .stampignore      │
-│  Exclude files from context compilation         │
-╰─────────────────────────────────────────────────╯
-
-USAGE:
-  stamp ignore <path1> [path2] ... [options]
-
-ARGUMENTS:
-  <path1> [path2] ...                 File or folder paths to ignore (relative to project root)
-
-OPTIONS:
-  --quiet, -q                         Suppress verbose output (show only errors)
-  -h, --help                          Show this help
-
-EXAMPLES:
-  stamp ignore src/secrets.ts
-    Add a single file to .stampignore
-
-  stamp ignore src/config/credentials.ts src/secrets/
-    Add multiple files/folders to .stampignore
-
-  stamp ignore "**/secrets.ts" "**/*.key"
-    Add glob patterns to .stampignore
-
-WHAT IT DOES:
-  • Adds file or folder paths to .stampignore
-  • Creates .stampignore if it doesn't exist
-  • Prevents duplicate entries
-  • Normalizes paths automatically
-
-NOTES:
-  • Paths are relative to project root
-  • Supports glob patterns (e.g., **/*.key, src/**/secrets.ts)
-  • Files in .stampignore are excluded from context compilation
-  • Use "stamp context" to verify files are excluded
+    return `
+╭─────────────────────────────────────────────────╮
+│  Stamp Ignore - Add Files to .stampignore      │
+│  Exclude files from context compilation         │
+╰─────────────────────────────────────────────────╯
+
+USAGE:
+  stamp ignore <path1> [path2] ... [options]
+
+ARGUMENTS:
+  <path1> [path2] ...                 File or folder paths to ignore (relative to project root)
+
+OPTIONS:
+  --quiet, -q                         Suppress verbose output (show only errors)
+  -h, --help                          Show this help
+
+EXAMPLES:
+  stamp ignore src/secrets.ts
+    Add a single file to .stampignore
+
+  stamp ignore src/config/credentials.ts src/secrets/
+    Add multiple files/folders to .stampignore
+
+  stamp ignore "**/secrets.ts" "**/*.key"
+    Add glob patterns to .stampignore
+
+WHAT IT DOES:
+  • Adds file or folder paths to .stampignore
+  • Creates .stampignore if it doesn't exist
+  • Prevents duplicate entries
+  • Normalizes paths automatically
+
+NOTES:
+  • Paths are relative to project root
+  • Supports glob patterns (e.g., **/*.key, src/**/secrets.ts)
+  • Files in .stampignore are excluded from context compilation
+  • Use "stamp context" to verify files are excluded
   `;
 }
 //# sourceMappingURL=helpText.js.map