feat: add AI-powered command suggestions for unrecognized commands

When a CLI command is not recognized, the CLI now asks an AI tool to
suggest the correct command. Features:

- Cascading fallback through AI tools: ollama → claude → copilot
- Address masking: 0x addresses are replaced with placeholders (0xAAAA,
  0xBBBB, etc.) before sending to AI and restored in the response
- Auto-detection of ollama models (prefers 2-5GB models)
- Dynamic extraction of available commands from Commander.js

AI tool configurations:
- ollama: auto-detects available model, uses --quiet flag
- claude: uses haiku model with --print flag
- copilot: uses claude-haiku-4.5 model with --prompt flag

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

Author: katspaugh

src/cli.ts

@@ -29,6 +29,7 @@ import { pullTransactions } from './commands/tx/pull.js'
 import { syncTransactions } from './commands/tx/sync.js'
 import { handleError } from './utils/errors.js'
 import { setGlobalOptions, type GlobalOptions } from './types/global-options.js'
+import { getAISuggestionService } from './services/ai-suggestion-service.js'
 
 const program = new Command()
 
@@ -53,8 +54,73 @@ program
     })
   })
 
+/**
+ * Recursively extracts all commands from a Commander program/command.
+ * Returns commands in format like "config init", "wallet list", etc.
+ */
+function getAvailableCommands(cmd: Command, prefix: string = ''): string[] {
+  const commands: string[] = []
+
+  for (const subCmd of cmd.commands) {
+    const cmdName = subCmd.name()
+    const fullName = prefix ? `${prefix} ${cmdName}` : cmdName
+    const usage = subCmd.usage()
+
+    // Add the command with its usage (arguments)
+    if (usage) {
+      commands.push(`${fullName} ${usage}`)
+    } else {
+      commands.push(fullName)
+    }
+
+    // Recursively get subcommands
+    commands.push(...getAvailableCommands(subCmd, fullName))
+  }
+
+  return commands
+}
+
+/**
+ * Adds an unknown command handler with AI suggestions to a command.
+ * @param cmd The command to add the handler to
+ * @param cmdPath The path to this command (e.g., "tx" or "config chains")
+ */
+function addUnknownCommandHandler(cmd: Command, cmdPath: string = ''): void {
+  cmd.on('command:*', async (operands: string[]) => {
+    const unknownCommand = operands[0]
+    const args = operands.slice(1)
+    const fullUnknown = cmdPath ? `${cmdPath} ${unknownCommand}` : unknownCommand
+
+    console.error(`error: unknown command '${fullUnknown}'`)
+
+    // Try to get AI suggestion
+    const aiService = getAISuggestionService()
+    console.error('\nAsking AI for suggestions...')
+
+    try {
+      const availableCommands = getAvailableCommands(program)
+      const suggestion = await aiService.getSuggestion(fullUnknown, args, availableCommands)
+      if (suggestion) {
+        console.error('\nAI suggestion:')
+        console.error(suggestion)
+      } else {
+        console.error('\nNo AI tools available for suggestions.')
+        console.error(`Run 'safe --help' to see available commands.`)
+      }
+    } catch {
+      console.error(`\nRun 'safe --help' to see available commands.`)
+    }
+
+    process.exit(1)
+  })
+}
+
+// Handle unknown commands at root level
+addUnknownCommandHandler(program)
+
 // Config commands
 const config = program.command('config').description('Manage CLI configuration')
+addUnknownCommandHandler(config, 'config')
 
 config
   .command('init')
@@ -80,6 +146,7 @@ config
 
 // Config chains commands
 const chains = config.command('chains').description('Manage chain configurations')
+addUnknownCommandHandler(chains, 'config chains')
 
 chains
   .command('list')
@@ -127,6 +194,7 @@ chains
 
 // Wallet commands
 const wallet = program.command('wallet').description('Manage wallets and signers')
+addUnknownCommandHandler(wallet, 'wallet')
 
 wallet
   .command('import')
@@ -207,6 +275,7 @@ wallet
 
 // Account commands
 const account = program.command('account').description('Manage Safe accounts')
+addUnknownCommandHandler(account, 'account')
 
 account
   .command('create')
@@ -316,6 +385,7 @@ account
 
 // Transaction commands
 const tx = program.command('tx').description('Manage Safe transactions')
+addUnknownCommandHandler(tx, 'tx')
 
 tx.command('create')
   .description('Create a new transaction')