Add more descriptive messages for using experimental & restricted options without the power mode enabled

Author: Gedochao

modules/cli/src/main/scala/scala/cli/commands/RestrictedCommandsParser.scala

@@ -6,6 +6,7 @@ import caseapp.core.parser.Parser
 import caseapp.core.util.Formatter
 import caseapp.core.{Arg, Error}
 
+import scala.cli.ScalaCli
 import scala.cli.util.ArgHelpers.*
 
 object RestrictedCommandsParser {
@@ -33,11 +34,13 @@ object RestrictedCommandsParser {
       nameFormatter: Formatter[Name]
     ): Either[(Error, Arg, List[String]), Option[(D, Arg, List[String])]] =
       (parser.step(args, index, d, nameFormatter), args) match {
-        case (Right(Some(_, arg, _)), passedOption :: _) if !arg.isSupported =>
+        case (Right(Some(_, arg: Arg, _)), passedOption :: _) if !arg.isSupported =>
+          val powerOptionType = if arg.isExperimental then "experimental" else "restricted"
           Left((
             Error.UnrecognizedArgument(
-              s"""`$passedOption` option is not supported.
-                 |Please run it with the `--power` flag or turn this flag on globally by running `config power true`.""".stripMargin
+              s"""The '$passedOption' option is $powerOptionType.
+                 |You can run it with the '--power' flag or turn the power mode on globally by running:
+                 |  ${Console.BOLD}${ScalaCli.progName} config power true${Console.RESET}.""".stripMargin
             ),
             arg,
             Nil

modules/cli/src/main/scala/scala/cli/util/ArgHelpers.scala

@@ -9,13 +9,16 @@ import scala.cli.commands.{SpecificationLevel, tags}
 
 object ArgHelpers {
   extension (arg: Arg) {
-    def isExperimentalOrRestricted: Boolean =
-      arg.tags.exists(_.name == tags.restricted) || arg.tags.exists(_.name == tags.experimental)
+    private def hasTag(tag: String): Boolean = arg.tags.exists(_.name == tag)
+    def isExperimental: Boolean              = arg.hasTag(tags.experimental)
+    def isRestricted: Boolean                = arg.hasTag(tags.restricted)
+
+    def isExperimentalOrRestricted: Boolean = arg.isRestricted || arg.isExperimental
 
     def isSupported: Boolean = allowRestrictedFeatures || !arg.isExperimentalOrRestricted
-    def isImportant: Boolean = arg.tags.exists(_.name == tags.inShortHelp)
+    def isImportant: Boolean = arg.hasTag(tags.inShortHelp)
 
-    def isMust: Boolean = arg.tags.exists(_.name == tags.must)
+    def isMust: Boolean = arg.hasTag(tags.must)
 
     def level: SpecificationLevel = arg.tags
       .flatMap(t => tags.levelFor(t.name))

modules/integration/src/test/scala/scala/cli/integration/SipScalaTests.scala

@@ -78,7 +78,7 @@ class SipScalaTests extends ScalaCliSuite {
     if (isRestricted) {
       expect(res.exitCode == 1)
       val output = res.out.text()
-      expect(output.contains(s"option is not supported"))
+      expect(output.contains(s"option is experimental"))
       expect(output.contains("--markdown"))
     }
     else expect(res.exitCode == 0)