feat: add interactive tour command for onboarding

- New 'socket tour' command for guided walkthrough
- 10-step interactive tour covering all major features
- Shows real commands users can run during tour
- Safe command execution for demonstrations
- Non-interactive mode shows tour summary
- Tour integrated into help system as option 1
- Highlights for new users in help menu

Tour covers:
1. Authentication setup
2. Vulnerability scanning
3. Package safety checks
4. Natural language interface
5. Fixing vulnerabilities
6. Secure package installation
7. Dependency optimization
8. Offline mode
9. CI/CD integration
10. Organization management

Each step includes:
- Clear explanations
- Example commands
- Tips and best practices
- Option to run safe commands

Usage:
- socket tour         # Start interactive tour
- socket --help       # Tour is option 1
- socket --help=tour  # Show tour info

Author: jdalton

src/commands.mts

@@ -35,6 +35,7 @@ import { cmdWhoami } from './commands/whoami/cmd-whoami.mts'
 import { cmdWrapper } from './commands/wrapper/cmd-wrapper.mts'
 import { cmdYarn } from './commands/yarn/cmd-yarn.mts'
 import { cmdAsk } from './commands/ask/cmd-ask.mts'
+import { cmdTour } from './commands/tour/cmd-tour.mts'
 import { isSeaBinary } from './utils/sea.mts'
 
 export const rootCommands = {
@@ -69,6 +70,7 @@ export const rootCommands = {
   security: cmdOrganizationPolicySecurity,
   ...(isSeaBinary() ? { 'self-update': cmdSelfUpdate } : {}),
   'threat-feed': cmdThreatFeed,
+  tour: cmdTour,
   uninstall: cmdUninstall,
   uv: cmdUv,
   whoami: cmdWhoami,

src/commands/tour/cmd-tour.mts

@@ -0,0 +1,20 @@
+/** @fileoverview Interactive tour command for Socket CLI */
+
+import { buildCommand } from '../../utils/command-builder.mts'
+import { runInteractiveTour, showTourSummary } from '../../utils/interactive-tour.mts'
+import isInteractive from '@socketregistry/is-interactive/index.cjs'
+
+export const cmdTour = buildCommand({
+  name: 'tour',
+  description: 'Interactive guided tour of Socket CLI features',
+  handler: async () => {
+    if (isInteractive()) {
+      await runInteractiveTour()
+    } else {
+      showTourSummary()
+    }
+  },
+  examples: [
+    { command: '', description: 'Start the interactive tour' },
+  ],
+})

src/utils/interactive-help.mts

@@ -15,6 +15,36 @@ interface HelpCategory {
 }
 
 const helpCategories: HelpCategory[] = [
+  {
+    title: 'Guided Tour',
+    key: 'tour',
+    icon: '🎯',
+    description: 'Take an interactive tour of Socket CLI',
+    content: () => {
+      logger.log(colors.cyan('\n🎯 Socket CLI Guided Tour\n'))
+      logger.log('The interactive tour will walk you through:')
+      logger.log('')
+      logger.log('  1. Authentication and setup')
+      logger.log('  2. Scanning for vulnerabilities')
+      logger.log('  3. Checking package safety')
+      logger.log('  4. Using natural language commands')
+      logger.log('  5. Fixing security issues')
+      logger.log('  6. Secure package installation')
+      logger.log('  7. Dependency optimization')
+      logger.log('  8. Offline mode and caching')
+      logger.log('  9. CI/CD integration')
+      logger.log('  10. Organization management')
+      logger.log('')
+      logger.log(colors.bold('To start the tour:'))
+      logger.log('  socket tour')
+      logger.log('')
+      logger.log(colors.gray('The tour is interactive and will:'))
+      logger.log(colors.gray('  • Show real commands you can use'))
+      logger.log(colors.gray('  • Let you run safe examples'))
+      logger.log(colors.gray('  • Provide tips and best practices'))
+      logger.log(colors.gray('  • Take about 5-10 minutes'))
+    },
+  },
   {
     title: 'Security Scanning',
     key: 'scan',
@@ -220,6 +250,7 @@ const helpCategories: HelpCategory[] = [
         { cmd: 'scan', desc: 'Security scanning' },
         { cmd: 'security', desc: 'Security policy' },
         { cmd: 'threat-feed', desc: 'Threat intelligence' },
+        { cmd: 'tour', desc: '🎯 Interactive guided tour' },
         { cmd: 'whoami', desc: 'Current user info' },
         { cmd: 'wrapper', desc: 'CDN wrapper' },
         { cmd: 'yarn', desc: 'Secure yarn wrapper' },
@@ -241,6 +272,9 @@ const helpCategories: HelpCategory[] = [
     description: 'Get started quickly',
     content: () => {
       logger.log(colors.cyan('\n🚀 Quick Start Guide\n'))
+      logger.log(colors.bold('New to Socket CLI?'))
+      logger.log('   socket tour                  # Take the interactive tour!')
+      logger.log('')
       logger.log(colors.bold('1. First-time setup:'))
       logger.log('   socket login                 # Authenticate')
       logger.log('   socket config auto            # Auto-configure')
@@ -277,7 +311,9 @@ export async function showInteractiveHelp(): Promise<void> {
     logger.log('')
     logger.log(colors.gray('Run with an interactive terminal to select a category'))
     logger.log(colors.gray('Or use: socket --help=<category>'))
-    logger.log(colors.gray('Categories: scan, fix, pm, pkg, org, config, ask, all, quick'))
+    logger.log(colors.gray('Categories: tour, scan, fix, pm, pkg, org, config, ask, all, quick'))
+    logger.log('')
+    logger.log(colors.bold('💡 New user? Try: socket tour'))
     return
   }
 
@@ -286,7 +322,8 @@ export async function showInteractiveHelp(): Promise<void> {
 
   try {
     while (true) {
-      logger.log(colors.bold('What can I help you with?\n'))
+      logger.log(colors.bold('What can I help you with?'))
+      logger.log(colors.dim('💡 New user? Start with option 1 for a guided tour!\n'))
       showCategoryList()
       logger.log('')