feat: page command defaults to TOC-only, adds --complete flag

scripts/rsw/internal/cmd/page.go

@@ -12,15 +12,18 @@ import (
 
 func newPageCmd() *cobra.Command {
 	var pageSection string
+	var complete bool
 
 	cmd := &cobra.Command{
 		Use:   "page <title>",
 		Short: "Fetch and display a wiki page",
-		Long: `Fetches a wiki page and renders it as markdown. Optionally filter
-to a specific section.
+		Long: `Fetches a wiki page and renders its table of contents by default.
+Use --section to get a specific section, or --complete for the full page.
 
 Examples:
   rsw osrs page "Dragon scimitar"
+  rsw osrs page "Dragon scimitar" --section "Combat styles"
+  rsw osrs page "Mining" --complete
   rsw rs3 page "Mining" --section "Training"`,
 		Args: cobra.MinimumNArgs(1),
 		RunE: func(cmd *cobra.Command, args []string) error {
@@ -74,13 +77,19 @@ Examples:
 				md.HR()
 			}
 
-			md.Line(htmlconv.Convert(page.HTML))
+			if complete {
+				md.Line(htmlconv.Convert(page.HTML))
+			} else {
+				md.Line("Use --section <name> to fetch a specific section, or --complete for the full page.")
+			}
+
 			fmt.Print(md.String())
 			return nil
 		},
 	}
 
 	cmd.Flags().StringVar(&pageSection, "section", "", "Fetch only the named section")
+	cmd.Flags().BoolVar(&complete, "complete", false, "Fetch the complete page content (default shows TOC only)")
 	return cmd
 }