Mark the PackageDescription manifest API as being available only with tools version 999.0 since this hasn't been approved yet.

Author: abertelrud

Sources/PackageDescription/Target.swift

@@ -131,6 +131,7 @@ public final class Target {
     /// this enum will be extended as new plugin capabilities are added.
     public enum PluginCapability {
         case _buildTool
+        @available(_PackageDescription, introduced: 999.0)
         case _command(intent: PluginCommandIntent, permissions: [PluginPermission])
     }
 
@@ -1015,7 +1016,7 @@ extension Target.PluginCapability {
     /// Specifies that the plugin provides a user command capability. It will
     /// be available to invoke manually on one or more targets in a package.
     /// The package can specify the verb that is used to invoke the command.
-    @available(_PackageDescription, introduced: 5.6)
+    @available(_PackageDescription, introduced: 999.0)
     /// Plugins that specify a `command` capability define commands that can be run
     /// using the SwiftPM CLI (`swift package <verb>`), or in an IDE that supports
     /// Swift Packages.
@@ -1033,6 +1034,7 @@ extension Target.PluginCapability {
     }
 }
 
+@available(_PackageDescription, introduced: 999.0)
 public enum PluginCommandIntent {
     /// The intent of the command is to generate documentation, either by parsing the
     /// package contents directly or by using the build system support for generating
@@ -1050,6 +1052,7 @@ public enum PluginCommandIntent {
     case custom(verb: String, description: String)
 }
 
+@available(_PackageDescription, introduced: 999.0)
 public enum PluginPermission {
     /// The custom command plugin requests permission to modify the files inside the
     /// package directory. The `reason` string is shown to the user at the time of

Tests/PackageLoadingTests/PD_5_6_LoadingTests.swift

@@ -94,31 +94,6 @@ class PackageDescription5_6LoadingTests: PackageDescriptionLoadingTests {
         XCTAssertEqual(manifest.targets[0].pluginCapability, .buildTool)
     }
 
-    func testCommandPluginTarget() throws {
-        let content = """
-            import PackageDescription
-            let package = Package(
-               name: "Foo",
-               targets: [
-                   .plugin(
-                       name: "Foo",
-                       capability: .command(
-                           intent: .custom(verb: "mycmd", description: "helpful description of mycmd"),
-                           permissions: [ .packageWritability(reason: "YOLO") ]
-                       )
-                   )
-               ]
-            )
-            """
-
-        let observability = ObservabilitySystem.makeForTesting()
-        let manifest = try loadManifest(content, observabilityScope: observability.topScope)
-        XCTAssertNoDiagnostics(observability.diagnostics)
-
-        XCTAssertEqual(manifest.targets[0].type, .plugin)
-        XCTAssertEqual(manifest.targets[0].pluginCapability, .command(intent: .custom(verb: "mycmd", description: "helpful description of mycmd"), permissions: [.packageWritability(reason: "YOLO")]))
-    }
-
     func testPluginTargetCustomization() throws {
         let content = """
             import PackageDescription

Tests/PackageLoadingTests/PD_Next_LoadingTests.swift

@@ -44,4 +44,29 @@ class PackageDescriptionNextLoadingTests: PackageDescriptionLoadingTests {
         XCTAssertEqual(deps["x.qux"], .registry(identity: "x.qux", requirement: .range("1.1.1" ..< "1.2.0")))
         XCTAssertEqual(deps["x.quux"], .registry(identity: "x.quux", requirement: .range("1.1.1" ..< "3.0.0")))
     }
+
+    func testCommandPluginTarget() throws {
+        let content = """
+            import PackageDescription
+            let package = Package(
+               name: "Foo",
+               targets: [
+                   .plugin(
+                       name: "Foo",
+                       capability: .command(
+                           intent: .custom(verb: "mycmd", description: "helpful description of mycmd"),
+                           permissions: [ .packageWritability(reason: "YOLO") ]
+                       )
+                   )
+               ]
+            )
+            """
+
+        let observability = ObservabilitySystem.makeForTesting()
+        let manifest = try loadManifest(content, observabilityScope: observability.topScope)
+        XCTAssertNoDiagnostics(observability.diagnostics)
+
+        XCTAssertEqual(manifest.targets[0].type, .plugin)
+        XCTAssertEqual(manifest.targets[0].pluginCapability, .command(intent: .custom(verb: "mycmd", description: "helpful description of mycmd"), permissions: [.packageWritability(reason: "YOLO")]))
+    }
 }