feat: sensible defaults for cli

focli simulate
focli portfolio

src/focli/README.md

@@ -33,9 +33,9 @@ portfolio load <path>
 Load your portfolio data from a CSV file. This is typically the first command you'll run to begin your analysis session.
 
 ```
-portfolio summary
+portfolio
 ```
-Get a high-level overview of your portfolio, including total value, exposure breakdown, and key risk metrics. This helps you understand your overall positioning at a glance.
+Get a high-level overview of your portfolio, including total value, exposure breakdown, and key risk metrics. This helps you understand your overall positioning at a glance. (Same as `portfolio summary`)
 
 ```
 portfolio list [options]
@@ -50,7 +50,7 @@ View all positions in your portfolio with filtering and sorting options:
 ### Simulation
 
 ```
-simulate spy [options]
+simulate [options]
 ```
 See how your portfolio might perform across different market scenarios:
 - `--range 20` - Set the range of market movement to analyze (±20%)
@@ -96,14 +96,14 @@ Exit the application.
 
 ```
 folio> portfolio load private-data/portfolio-private.csv
-folio> portfolio summary
-folio> simulate spy --range 15 --steps 11
+folio> portfolio
+folio> simulate --range 15 --steps 11
 folio> position SPY risk
 folio> position AAPL simulate --range 20
 folio> portfolio list --options --sort value
 ```
 
-This workflow gives you a complete picture of your portfolio's risk profile and behavior in different market conditions, focusing on the positions that matter most.
+This workflow gives you a complete picture of your portfolio's risk profile and behavior in different market conditions, focusing on the positions that matter most. Notice how commands use sensible defaults, making the interface more intuitive and requiring fewer keystrokes for common operations.
 
 ## Getting Help
 

src/focli/commands/help.py

@@ -43,25 +43,28 @@ def help_command(args: list[str], state: dict[str, Any], console):  # noqa: ARG0
 
         if command == "simulate":
             console.print(
-                "  [green]simulate spy[/green] - Run a simulation with default parameters"
+                "  [green]simulate[/green] - Run a simulation with default parameters (SPY benchmark)"
             )
             console.print(
-                "  [green]simulate spy --range 10 --steps 21[/green] - Run a simulation with ±10% range and 21 steps"
+                "  [green]simulate --range 10 --steps 21[/green] - Run a simulation with ±10% range and 21 steps"
             )
             console.print(
-                "  [green]simulate spy --focus SPY,AAPL[/green] - Run a simulation focusing on specific tickers"
+                "  [green]simulate --focus SPY,AAPL[/green] - Run a simulation focusing on specific tickers"
             )
             console.print(
-                "  [green]simulate spy --detailed[/green] - Run a simulation with detailed position analysis"
+                "  [green]simulate --detailed[/green] - Run a simulation with detailed position analysis"
             )
             console.print(
-                "  [green]simulate spy --preset detailed[/green] - Run a simulation using a saved preset"
+                "  [green]simulate --preset detailed[/green] - Run a simulation using a saved preset"
             )
             console.print(
-                "  [green]simulate spy --save-preset my_preset[/green] - Save current parameters as a preset"
+                "  [green]simulate --save-preset my_preset[/green] - Save current parameters as a preset"
             )
             console.print(
-                "  [green]simulate spy --filter options[/green] - Run a simulation only on positions with options"
+                "  [green]simulate --filter options[/green] - Run a simulation only on positions with options"
+            )
+            console.print(
+                "  [green]simulate spy[/green] - Explicitly specify SPY benchmark (same as 'simulate')"
             )
 
         elif command == "position":
@@ -82,6 +85,9 @@ def help_command(args: list[str], state: dict[str, Any], console):  # noqa: ARG0
             )
 
         elif command == "portfolio":
+            console.print(
+                "  [green]portfolio[/green] - Show a summary of the portfolio (same as 'portfolio summary')"
+            )
             console.print(
                 "  [green]portfolio summary[/green] - Show a summary of the portfolio"
             )

src/focli/commands/portfolio.py

@@ -23,11 +23,8 @@ def portfolio_command(args: list[str], state: dict[str, Any], console):
     """
     # Check if we have a subcommand
     if not args:
-        console.print(
-            "[bold yellow]Usage:[/bold yellow] portfolio <subcommand> [options]"
-        )
-        console.print("Available subcommands: list, summary, load")
-        console.print("Type 'help portfolio' for more information.")
+        # Default to summary if no subcommand is specified
+        portfolio_summary([], state, console)
         return
 
     subcommand = args[0].lower()

src/focli/commands/simulate.py

@@ -26,27 +26,28 @@ def simulate_command(args: list[str], state: dict[str, Any], console):
         console.print("Use 'portfolio load <path>' to load a portfolio.")
         return
 
-    # Check if we have a subcommand
+    # Check if we have a subcommand or arguments
     if not args:
-        console.print(
-            "[bold yellow]Usage:[/bold yellow] simulate <subcommand> [options]"
-        )
-        console.print("Available subcommands: spy, scenario")
-        console.print("Type 'help simulate' for more information.")
+        # Default to SPY simulation with default parameters
+        simulate_spy([], state, console)
         return
 
-    subcommand = args[0].lower()
-    subcommand_args = args[1:]
+    # Check if the first argument is a subcommand
+    first_arg = args[0].lower()
+    if first_arg in ["spy", "scenario"]:
+        # It's a subcommand
+        subcommand = first_arg
+        subcommand_args = args[1:]
 
-    if subcommand == "spy":
-        simulate_spy(subcommand_args, state, console)
-    elif subcommand == "scenario":
-        console.print(
-            "[bold yellow]Note:[/bold yellow] Scenario simulation is not yet implemented."
-        )
+        if subcommand == "spy":
+            simulate_spy(subcommand_args, state, console)
+        elif subcommand == "scenario":
+            console.print(
+                "[bold yellow]Note:[/bold yellow] Scenario simulation is not yet implemented."
+            )
     else:
-        console.print(f"[bold red]Unknown subcommand:[/bold red] {subcommand}")
-        console.print("Available subcommands: spy, scenario")
+        # No subcommand specified, assume SPY simulation with the provided arguments
+        simulate_spy(args, state, console)
 
 
 def simulate_spy(args: list[str], state: dict[str, Any], console):