Introduce GlobalCommand to indicate some commands alwasy be available

Closes gh-967

See gh-962 gh-963

Author: rainboyan

grace-shell/src/main/groovy/org/grails/cli/profile/GlobalCommand.groovy

@@ -0,0 +1,29 @@
+/*
+ * Copyright 2022-2025 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.grails.cli.profile
+
+import groovy.transform.CompileStatic
+
+/**
+ * A marker interface that indicates that this command could be used in or out a project
+ *
+ * @author Michael Yan
+ * @since 2023.3.0
+ */
+@CompileStatic
+interface GlobalCommand extends Command {
+
+}

grace-shell/src/main/groovy/org/grails/cli/profile/commands/HelpCommand.groovy

@@ -25,6 +25,7 @@ import org.grails.cli.profile.Command
 import org.grails.cli.profile.CommandArgument
 import org.grails.cli.profile.CommandDescription
 import org.grails.cli.profile.ExecutionContext
+import org.grails.cli.profile.GlobalCommand
 import org.grails.cli.profile.Profile
 import org.grails.cli.profile.ProfileCommand
 import org.grails.cli.profile.ProfileRepository
@@ -178,7 +179,7 @@ grace [environment]* [target] [arguments]*'
         }
         else {
             commands = CommandRegistry.findCommands(profileRepository).findAll { Command cmd ->
-                !(cmd instanceof ProjectCommand)
+                (cmd instanceof GlobalCommand) || !(cmd instanceof ProjectCommand)
             }
         }
         if (showAll) {

grace-shell/src/main/groovy/org/grails/cli/profile/commands/ListPluginsCommand.groovy

@@ -21,6 +21,7 @@ import grails.build.logging.GrailsConsole
 import org.grails.cli.profile.Command
 import org.grails.cli.profile.CommandDescription
 import org.grails.cli.profile.ExecutionContext
+import org.grails.cli.profile.GlobalCommand
 import org.grails.cli.profile.ProjectCommand
 
 /**
@@ -30,7 +31,7 @@ import org.grails.cli.profile.ProjectCommand
  * @since 2023.3.0
  */
 @CompileStatic
-class ListPluginsCommand implements Command, ProjectCommand {
+class ListPluginsCommand implements Command, GlobalCommand, ProjectCommand {
 
     public static final String PLUGIN_REPO_URL = 'https://repo1.maven.org/maven2/org/graceframework/plugins'
     private static final List<String> EXCLUDES = ['asset-pipeline-core', 'asset-pipeline-gradle', 'views-gradle']

grace-shell/src/main/groovy/org/grails/cli/profile/commands/ListProfilesCommand.groovy

@@ -18,10 +18,11 @@ package org.grails.cli.profile.commands
 import groovy.transform.CompileStatic
 
 import grails.build.logging.GrailsConsole
-
+import grails.util.BuildSettings
 import org.grails.cli.profile.Command
 import org.grails.cli.profile.CommandDescription
 import org.grails.cli.profile.ExecutionContext
+import org.grails.cli.profile.GlobalCommand
 import org.grails.cli.profile.Profile
 import org.grails.cli.profile.ProfileRepository
 import org.grails.cli.profile.ProfileRepositoryAware
@@ -35,7 +36,7 @@ import org.grails.cli.profile.ProjectCommand
  * @since 3.0
  */
 @CompileStatic
-class ListProfilesCommand implements Command, ProjectCommand, ProfileRepositoryAware {
+class ListProfilesCommand implements Command, GlobalCommand, ProjectCommand, ProfileRepositoryAware {
 
     final String name = 'list-profiles'
     final CommandDescription description = new CommandDescription(name, 'Lists the available profiles', 'grace list-profiles')
@@ -47,7 +48,7 @@ class ListProfilesCommand implements Command, ProjectCommand, ProfileRepositoryA
         List<Profile> allProfiles = profileRepository.allProfiles.sort { Profile p -> p.name}
         GrailsConsole console = executionContext.console
         console.log('-' * 100)
-        console.log('Available Profiles')
+        console.log(BuildSettings.GRAILS_APP_DIR_PRESENT ? 'Used Profiles' : 'Available Profiles')
         console.log('-' * 100)
         for (Profile p in allProfiles) {
             console.log("* ${p.name.padRight(30)} ${p.version.padRight(20)}  ${p.description}")

grace-shell/src/main/groovy/org/grails/cli/profile/commands/PluginInfoCommand.groovy

@@ -23,6 +23,7 @@ import org.grails.build.parsing.CommandLine
 import org.grails.cli.profile.Command
 import org.grails.cli.profile.CommandDescription
 import org.grails.cli.profile.ExecutionContext
+import org.grails.cli.profile.GlobalCommand
 import org.grails.cli.profile.ProjectCommand
 
 /**
@@ -31,7 +32,7 @@ import org.grails.cli.profile.ProjectCommand
  * @author Michael Yan
  * @since 2023.3.0
  */
-class PluginInfoCommand implements Command, ProjectCommand {
+class PluginInfoCommand implements Command, GlobalCommand, ProjectCommand {
 
     public static final String PLUGIN_REPO_URL = 'https://repo1.maven.org/maven2/org/graceframework/plugins'
     public static final String NAME = 'plugin-info'

grace-shell/src/main/groovy/org/grails/cli/profile/commands/ProfileInfoCommand.groovy

@@ -24,6 +24,7 @@ import org.grails.cli.profile.Command
 import org.grails.cli.profile.CommandDescription
 import org.grails.cli.profile.ExecutionContext
 import org.grails.cli.profile.Feature
+import org.grails.cli.profile.GlobalCommand
 import org.grails.cli.profile.Profile
 import org.grails.cli.profile.ProfileRepository
 import org.grails.cli.profile.ProfileRepositoryAware
@@ -39,7 +40,7 @@ import org.grails.config.CodeGenConfig
  * @since 3.1
  */
 @CompileStatic
-class ProfileInfoCommand extends ArgumentCompletingCommand implements ProjectCommand, ProfileRepositoryAware {
+class ProfileInfoCommand extends ArgumentCompletingCommand implements GlobalCommand, ProjectCommand, ProfileRepositoryAware {
 
     public static final String NAME = 'profile-info'