nx 22.0.0-beta.3 → 22.0.0-beta.5

package/migrations.json

@@ -93,6 +93,11 @@
       "version": "22.0.0-beta.1",
       "description": "Updates release version config based on the breaking changes in Nx v22",
       "implementation": "./src/migrations/update-22-0-0/release-version-config-changes"
+    },
+    "22-0-0-consolidate-release-tag-config": {
+      "version": "22.0.0-beta.2",
+      "description": "Consolidates releaseTag* options into nested releaseTag object structure",
+      "implementation": "./src/migrations/update-22-0-0/consolidate-release-tag-config"
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nx",
-  "version": "22.0.0-beta.3",
+  "version": "22.0.0-beta.5",
   "private": false,
   "description": "The core Nx plugin contains the core functionality of Nx like the project graph, nx commands and task orchestration.",
   "repository": {
@@ -83,16 +83,16 @@
     }
   },
   "optionalDependencies": {
-    "@nx/nx-darwin-arm64": "22.0.0-beta.3",
-    "@nx/nx-darwin-x64": "22.0.0-beta.3",
-    "@nx/nx-freebsd-x64": "22.0.0-beta.3",
-    "@nx/nx-linux-arm-gnueabihf": "22.0.0-beta.3",
-    "@nx/nx-linux-arm64-gnu": "22.0.0-beta.3",
-    "@nx/nx-linux-arm64-musl": "22.0.0-beta.3",
-    "@nx/nx-linux-x64-gnu": "22.0.0-beta.3",
-    "@nx/nx-linux-x64-musl": "22.0.0-beta.3",
-    "@nx/nx-win32-arm64-msvc": "22.0.0-beta.3",
-    "@nx/nx-win32-x64-msvc": "22.0.0-beta.3"
+    "@nx/nx-darwin-arm64": "22.0.0-beta.5",
+    "@nx/nx-darwin-x64": "22.0.0-beta.5",
+    "@nx/nx-freebsd-x64": "22.0.0-beta.5",
+    "@nx/nx-linux-arm-gnueabihf": "22.0.0-beta.5",
+    "@nx/nx-linux-arm64-gnu": "22.0.0-beta.5",
+    "@nx/nx-linux-arm64-musl": "22.0.0-beta.5",
+    "@nx/nx-linux-x64-gnu": "22.0.0-beta.5",
+    "@nx/nx-linux-x64-musl": "22.0.0-beta.5",
+    "@nx/nx-win32-arm64-msvc": "22.0.0-beta.5",
+    "@nx/nx-win32-x64-msvc": "22.0.0-beta.5"
   },
   "nx-migrations": {
     "migrations": "./migrations.json",

package/release/changelog-renderer/index.d.ts

@@ -95,6 +95,7 @@ export default class DefaultChangelogRenderer {
     protected shouldRenderAuthors(): boolean;
     protected renderAuthors(): Promise<string[]>;
     protected formatChange(change: ChangelogChange): string;
+    protected formatBreakingChange(change: ChangelogChange): string;
     protected groupChangesByType(): Record<string, ChangelogChange[]>;
     protected groupChangesByScope(changes: ChangelogChange[]): Record<string, ChangelogChange[]>;
     protected extractBreakingChangeExplanation(message: string): string | null;

package/release/changelog-renderer/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/nx/release/changelog-renderer/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/nx/release/changelog-renderer/index.ts"],"names":[],"mappings":"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"}

package/release/changelog-renderer/index.js

@@ -105,10 +105,7 @@ class DefaultChangelogRenderer {
         else {
             for (const change of this.relevantChanges) {
                 if (change.isBreaking) {
-                    const breakingChangeExplanation = this.extractBreakingChangeExplanation(change.body);
-                    this.breakingChanges.push(breakingChangeExplanation
-                        ? `- ${change.scope ? `**${change.scope.trim()}:** ` : ''}${breakingChangeExplanation}`
-                        : this.formatChange(change));
+                    this.breakingChanges.push(this.formatBreakingChange(change));
                 }
             }
         }
@@ -170,10 +167,7 @@ class DefaultChangelogRenderer {
                         const line = this.formatChange(change);
                         markdownLines.push(line);
                         if (change.isBreaking && !this.isVersionPlans) {
-                            const breakingChangeExplanation = this.extractBreakingChangeExplanation(change.body);
-                            this.breakingChanges.push(breakingChangeExplanation
-                                ? `- ${change.scope ? `**${change.scope.trim()}:** ` : ''}${breakingChangeExplanation}`
-                                : line);
+                            this.breakingChanges.push(this.formatBreakingChange(change));
                         }
                     }
                 }
@@ -184,10 +178,7 @@ class DefaultChangelogRenderer {
                     const line = this.formatChange(change);
                     markdownLines.push(line);
                     if (change.isBreaking && !this.isVersionPlans) {
-                        const breakingChangeExplanation = this.extractBreakingChangeExplanation(change.body);
-                        this.breakingChanges.push(breakingChangeExplanation
-                            ? `- ${change.scope ? `**${change.scope.trim()}:** ` : ''}${breakingChangeExplanation}`
-                            : line);
+                        this.breakingChanges.push(this.formatBreakingChange(change));
                     }
                 }
             }
@@ -285,6 +276,43 @@ class DefaultChangelogRenderer {
         }
         return changeLine;
     }
+    formatBreakingChange(change) {
+        const explanation = this.extractBreakingChangeExplanation(change.body);
+        if (!explanation) {
+            // No explanation found, use the regular formatChange which includes references
+            return this.formatChange(change);
+        }
+        // Build the breaking change line with scope, explanation, and references
+        let breakingLine = '- ';
+        if (change.scope) {
+            breakingLine += `**${change.scope.trim()}:** `;
+        }
+        // Handle multi-line explanations
+        let explanationText = explanation;
+        let extraLines = [];
+        if (explanation.includes('\n')) {
+            [explanationText, ...extraLines] = explanation.split('\n');
+        }
+        breakingLine += explanationText;
+        // Add PR/commit references
+        if (this.remoteReleaseClient.getRemoteRepoData() &&
+            this.changelogRenderOptions.commitReferences &&
+            change.githubReferences) {
+            breakingLine += this.remoteReleaseClient.formatReferences(change.githubReferences);
+        }
+        // Add extra lines with indentation (matching formatChange behavior)
+        if (extraLines.length > 0) {
+            const indentation = '  ';
+            const extraLinesStr = extraLines
+                .filter((l) => l.trim().length > 0)
+                .map((l) => `${indentation}${l}`)
+                .join('\n');
+            if (extraLinesStr) {
+                breakingLine += '\n\n' + extraLinesStr;
+            }
+        }
+        return breakingLine;
+    }
     groupChangesByType() {
         const typeGroups = {};
         for (const change of this.relevantChanges) {
@@ -312,9 +340,12 @@ class DefaultChangelogRenderer {
             return null;
         }
         const startOfBreakingChange = startIndex + breakingChangeIdentifier.length;
-        const endOfBreakingChange = message.indexOf('\n', startOfBreakingChange);
-        if (endOfBreakingChange === -1) {
-            return message.substring(startOfBreakingChange).trim();
+        // Extract all text after BREAKING CHANGE: until we hit git metadata
+        let endOfBreakingChange = message.length;
+        // Look for the git metadata delimiter (a line with just ")
+        const gitMetadataMarker = message.indexOf('\n"', startOfBreakingChange);
+        if (gitMetadataMarker !== -1) {
+            endOfBreakingChange = gitMetadataMarker;
         }
         return message.substring(startOfBreakingChange, endOfBreakingChange).trim();
     }

package/schemas/nx-schema.json

@@ -160,90 +160,136 @@
         },
         "groups": {
           "type": "object",
-          "properties": {
-            "projectsRelationship": {
-              "type": "string",
-              "enum": ["fixed", "independent"]
-            },
-            "projects": {
-              "oneOf": [
-                {
-                  "type": "string",
-                  "description": "A project name"
-                },
-                {
-                  "type": "array",
-                  "description": "An array of project names",
-                  "minItems": 1,
-                  "items": {
-                    "type": "string"
+          "additionalProperties": {
+            "type": "object",
+            "properties": {
+              "projectsRelationship": {
+                "type": "string",
+                "enum": ["fixed", "independent"]
+              },
+              "projects": {
+                "oneOf": [
+                  {
+                    "type": "string",
+                    "description": "A project name"
+                  },
+                  {
+                    "type": "array",
+                    "description": "An array of project names",
+                    "minItems": 1,
+                    "items": {
+                      "type": "string"
+                    }
                   }
-                }
-              ]
-            },
-            "version": {
-              "$ref": "#/definitions/NxReleaseGroupVersionConfiguration"
-            },
-            "changelog": {
-              "oneOf": [
-                {
-                  "$ref": "#/definitions/NxReleaseChangelogConfiguration"
-                },
-                {
-                  "type": "boolean"
-                }
-              ]
-            },
-            "releaseTagPattern": {
-              "type": "string",
-              "description": "Optionally override the git/release tag pattern to use for this group."
-            },
-            "releaseTagPatternCheckAllBranchesWhen": {
-              "oneOf": [
-                {
-                  "type": "boolean"
-                },
-                {
-                  "type": "array",
-                  "items": {
-                    "type": "string"
+                ]
+              },
+              "version": {
+                "$ref": "#/definitions/NxReleaseGroupVersionConfiguration"
+              },
+              "changelog": {
+                "oneOf": [
+                  {
+                    "$ref": "#/definitions/NxReleaseChangelogConfiguration"
+                  },
+                  {
+                    "type": "boolean"
+                  }
+                ]
+              },
+              "releaseTag": {
+                "type": "object",
+                "description": "Configuration for release tag generation and matching.",
+                "properties": {
+                  "pattern": {
+                    "type": "string",
+                    "description": "Optionally override the git/release tag pattern to use for this group."
+                  },
+                  "checkAllBranchesWhen": {
+                    "oneOf": [
+                      {
+                        "type": "boolean"
+                      },
+                      {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        }
+                      }
+                    ],
+                    "description": "By default, we will try and resolve the latest match for the releaseTagPattern from the current branch, falling back to all branches if no match is found on the current branch. Setting this to true will cause us to ALWAYS check all branches for the latest match. Setting it to false will cause us to ONLY check the current branch for the latest match. Setting it to an array of strings will cause us to check all branches WHEN the current branch is one of the strings in the array. Glob patterns are supported."
+                  },
+                  "requireSemver": {
+                    "type": "boolean",
+                    "description": "Whether to require semver to be used for the release tag pattern. If set to false, the release tag pattern will not be checked for semver compliance."
+                  },
+                  "preferDockerVersion": {
+                    "type": ["boolean", "string"],
+                    "enum": [true, false, "both"],
+                    "description": "Controls how docker versions are used relative to semver versions when creating git tags and changelog entries. Set to true to use only the docker version, false to use only the semver version, or 'both' to create tags and changelog entries for both docker and semver versions. By default, this is set to true when docker configuration is present, and false otherwise."
+                  },
+                  "strictPreid": {
+                    "$ref": "#/definitions/NxReleaseReleaseTagPatternStrictPreidConfiguration"
                   }
-                }
-              ],
-              "description": "By default, we will try and resolve the latest match for the releaseTagPattern from the current branch, falling back to all branches if no match is found on the current branch. Setting this to true will cause us to ALWAYS check all branches for the latest match. Setting it to false will cause us to ONLY check the current branch for the latest match. Setting it to an array of strings will cause us to check all branches WHEN the current branch is one of the strings in the array. Glob patterns are supported."
-            },
-            "releaseTagPatternRequireSemver": {
-              "type": "boolean",
-              "description": "Whether to require semver to be used for the release tag pattern. If set to false, the release tag pattern will not be checked for semver compliance."
-            },
-            "releaseTagPatternStrictPreid": {
-              "$ref": "#/definitions/NxReleaseReleaseTagPatternStrictPreidConfiguration"
-            },
-            "versionPlans": {
-              "oneOf": [
-                {
-                  "$ref": "#/definitions/NxReleaseVersionPlansConfiguration"
                 },
-                {
-                  "type": "boolean",
-                  "description": "Enables using version plans as a specifier source for versioning and to determine changes for changelog generation."
-                }
-              ]
+                "additionalProperties": false
+              },
+              "releaseTagPattern": {
+                "type": "string",
+                "description": "DEPRECATED: Use releaseTag.pattern instead. Will be removed in Nx 23."
+              },
+              "releaseTagPatternCheckAllBranchesWhen": {
+                "oneOf": [
+                  {
+                    "type": "boolean"
+                  },
+                  {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  }
+                ],
+                "description": "DEPRECATED: Use releaseTag.checkAllBranchesWhen instead. Will be removed in Nx 23."
+              },
+              "releaseTagPatternRequireSemver": {
+                "type": "boolean",
+                "description": "DEPRECATED: Use releaseTag.requireSemver instead. Will be removed in Nx 23."
+              },
+              "releaseTagPatternPreferDockerVersion": {
+                "type": ["boolean", "string"],
+                "enum": [true, false, "both"],
+                "description": "DEPRECATED: Use releaseTag.preferDockerVersion instead. Will be removed in Nx 23."
+              },
+              "releaseTagPatternStrictPreid": {
+                "$ref": "#/definitions/NxReleaseReleaseTagPatternStrictPreidConfiguration",
+                "description": "DEPRECATED: Use releaseTag.strictPreid instead. Will be removed in Nx 23."
+              },
+              "versionPlans": {
+                "oneOf": [
+                  {
+                    "$ref": "#/definitions/NxReleaseVersionPlansConfiguration"
+                  },
+                  {
+                    "type": "boolean",
+                    "description": "Enables using version plans as a specifier source for versioning and to determine changes for changelog generation."
+                  }
+                ]
+              },
+              "docker": {
+                "oneOf": [
+                  {
+                    "type": "boolean",
+                    "enum": [true],
+                    "description": "Enable docker configuration with default settings. Warning: Docker support is experimental. Breaking changes may occur and not adhere to semver versioning. "
+                  },
+                  {
+                    "$ref": "#/definitions/NxReleaseGroupDockerConfiguration"
+                  }
+                ]
+              }
             },
-            "docker": {
-              "oneOf": [
-                {
-                  "type": "boolean",
-                  "enum": [true],
-                  "description": "Enable docker configuration with default settings. Warning: Docker support is experimental. Breaking changes may occur and not adhere to semver versioning. "
-                },
-                {
-                  "$ref": "#/definitions/NxReleaseGroupDockerConfiguration"
-                }
-              ]
-            }
-          },
-          "required": ["projects"]
+            "required": ["projects"]
+          }
         },
         "changelog": {
           "type": "object",
@@ -301,9 +347,46 @@
             }
           ]
         },
+        "releaseTag": {
+          "type": "object",
+          "description": "Configuration for release tag generation and matching.",
+          "properties": {
+            "pattern": {
+              "type": "string",
+              "description": "Optionally override the git/release tag pattern to use. This field is the source of truth for changelog generation and release tagging, as well as for conventional commits parsing. It supports interpolating the version as {version} and (if releasing independently or forcing project level version control system releases) the project name as {projectName} within the string. The default releaseTagPattern for fixed/unified releases is: \"v{version}\". The default releaseTagPattern for independent releases at the project level is: \"{projectName}@{version}\""
+            },
+            "checkAllBranchesWhen": {
+              "oneOf": [
+                {
+                  "type": "boolean"
+                },
+                {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                }
+              ],
+              "description": "By default, we will try and resolve the latest match for the releaseTagPattern from the current branch, falling back to all branches if no match is found on the current branch. Setting this to true will cause us to ALWAYS check all branches for the latest match. Setting it to false will cause us to ONLY check the current branch for the latest match. Setting it to an array of strings will cause us to check all branches WHEN the current branch is one of the strings in the array. Glob patterns are supported."
+            },
+            "requireSemver": {
+              "type": "boolean",
+              "description": "Whether to require semver to be used for the release tag pattern. If set to false, the release tag pattern will not be checked for semver compliance."
+            },
+            "preferDockerVersion": {
+              "type": ["boolean", "string"],
+              "enum": [true, false, "both"],
+              "description": "Controls how docker versions are used relative to semver versions when creating git tags and changelog entries. Set to true to use only the docker version, false to use only the semver version, or 'both' to create tags and changelog entries for both docker and semver versions. By default, this is set to true when docker configuration is present, and false otherwise."
+            },
+            "strictPreid": {
+              "$ref": "#/definitions/NxReleaseReleaseTagPatternStrictPreidConfiguration"
+            }
+          },
+          "additionalProperties": false
+        },
         "releaseTagPattern": {
           "type": "string",
-          "description": "Optionally override the git/release tag pattern to use. This field is the source of truth for changelog generation and release tagging, as well as for conventional commits parsing. It supports interpolating the version as {version} and (if releasing independently or forcing project level version control system releases) the project name as {projectName} within the string. The default releaseTagPattern for fixed/unified releases is: \"v{version}\". The default releaseTagPattern for independent releases at the project level is: \"{projectName}@{version}\""
+          "description": "DEPRECATED: Use releaseTag.pattern instead. Will be removed in Nx 23."
         },
         "releaseTagPatternCheckAllBranchesWhen": {
           "oneOf": [
@@ -317,14 +400,20 @@
               }
             }
           ],
-          "description": "By default, we will try and resolve the latest match for the releaseTagPattern from the current branch, falling back to all branches if no match is found on the current branch. Setting this to true will cause us to ALWAYS check all branches for the latest match. Setting it to false will cause us to ONLY check the current branch for the latest match. Setting it to an array of strings will cause us to check all branches WHEN the current branch is one of the strings in the array. Glob patterns are supported."
+          "description": "DEPRECATED: Use releaseTag.checkAllBranchesWhen instead. Will be removed in Nx 23."
         },
         "releaseTagPatternRequireSemver": {
           "type": "boolean",
-          "description": "Whether to require semver to be used for the release tag pattern. If set to false, the release tag pattern will not be checked for semver compliance."
+          "description": "DEPRECATED: Use releaseTag.requireSemver instead. Will be removed in Nx 23."
+        },
+        "releaseTagPatternPreferDockerVersion": {
+          "type": ["boolean", "string"],
+          "enum": [true, false, "both"],
+          "description": "DEPRECATED: Use releaseTag.preferDockerVersion instead. Will be removed in Nx 23."
         },
         "releaseTagPatternStrictPreid": {
-          "$ref": "#/definitions/NxReleaseReleaseTagPatternStrictPreidConfiguration"
+          "$ref": "#/definitions/NxReleaseReleaseTagPatternStrictPreidConfiguration",
+          "description": "DEPRECATED: Use releaseTag.strictPreid instead. Will be removed in Nx 23."
         },
         "docker": {
           "oneOf": [
@@ -371,6 +460,85 @@
         }
       },
       "additionalProperties": false
+    },
+    "conformance": {
+      "type": "object",
+      "description": "Configuration for Nx Conformance",
+      "properties": {
+        "outputPath": {
+          "oneOf": [
+            {
+              "type": "string",
+              "description": "Path to write the conformance results to"
+            },
+            {
+              "type": "boolean",
+              "enum": [false],
+              "description": "Disable writing the conformance results to a file"
+            }
+          ],
+          "description": "Optional path to write the conformance results to, defaults to 'dist/conformance-result.json'. Set to false to disable writing the conformance results to a file."
+        },
+        "rules": {
+          "type": "array",
+          "description": "List of conformance rules to apply",
+          "items": {
+            "type": "object",
+            "properties": {
+              "rule": {
+                "type": "string",
+                "description": "Relative path to a local rule implementation, node_module path or nx-cloud rule ID for Nx Cloud Enterprise."
+              },
+              "options": {
+                "type": "object",
+                "description": "Rule specific configuration options.",
+                "additionalProperties": true
+              },
+              "projects": {
+                "type": "array",
+                "description": "The projects to apply this rule to. This property accepts an array of strings which can be project names, glob patterns, directories, tag references or anything else that is supported by the `--projects` filter. By default, the implied value is ['*'] (all projects). You can also use objects with 'matcher' and 'explanation' properties to document why specific projects are included or excluded.",
+                "items": {
+                  "oneOf": [
+                    {
+                      "type": "string",
+                      "description": "A project name, glob pattern, directory, tag reference, or any other valid project filter"
+                    },
+                    {
+                      "type": "object",
+                      "properties": {
+                        "matcher": {
+                          "type": "string",
+                          "description": "A project name, glob pattern, directory, tag reference, or any other valid project filter"
+                        },
+                        "explanation": {
+                          "type": "string",
+                          "description": "An explanation to communicate to colleagues why this particular project or projects were included or excluded from the rule"
+                        }
+                      },
+                      "required": ["matcher", "explanation"],
+                      "additionalProperties": false
+                    }
+                  ]
+                }
+              },
+              "explanation": {
+                "type": "string",
+                "description": "Optional explanation field for users to be able to communicate to their colleagues why a particular rule is enabled and important to the workspace in question."
+              },
+              "status": {
+                "type": "string",
+                "enum": ["enforced", "evaluated", "disabled"],
+                "description": "Override the default status of the rule, which is 'enforced'. If set to 'evaluated', the rule will be reported as normal, but not enforced (will exit with code 0). If set to 'disabled', the rule will not be evaluated at all.",
+                "default": "enforced"
+              }
+            },
+            "required": ["rule"],
+            "additionalProperties": false
+          }
+        }
+      },
+      "required": ["rules"],
+      "additionalProperties": false
     }
   },
   "definitions": {
@@ -833,9 +1001,9 @@
         },
         "updateDependents": {
           "type": "string",
-          "enum": ["never", "auto"],
+          "enum": ["never", "auto", "always"],
           "default": "auto",
-          "description": "When versioning independent projects, this controls whether to update their dependents (i.e. the things that depend on them). 'never' means no dependents will be updated (unless they happen to be versioned directly as well). 'auto' is the default and will cause dependents to be updated (a patch version bump) when a dependency is versioned."
+          "description": "When versioning independent projects, this controls whether to update their dependents (i.e. the things that depend on them). 'never' means no dependents will be updated (unless they happen to be versioned directly as well). 'auto' is the default and will cause dependents to be updated (a patch version bump) when a dependency is versioned, as long as a group or projects filter is not applied that does not include them. 'always' will cause dependents to be updated (a patch version bump) when a dependency is versioned, even if they are not included in the group or projects filter."
         },
         "logUnchangedProjects": {
           "type": "boolean",

package/src/command-line/configure-ai-agents/command-object.d.ts

@@ -3,7 +3,7 @@ export interface ConfigureAiAgentsOptions {
     agents?: string[];
     interactive?: boolean;
     verbose?: boolean;
-    check?: boolean;
+    check?: boolean | 'outdated' | 'all';
 }
 export declare const yargsConfigureAiAgentsCommand: CommandModule<{}, ConfigureAiAgentsOptions>;
 //# sourceMappingURL=command-object.d.ts.map

package/src/command-line/configure-ai-agents/command-object.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-object.d.ts","sourceRoot":"","sources":["../../../../../../packages/nx/src/command-line/configure-ai-agents/command-object.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAGtC,MAAM,WAAW,wBAAwB;IACvC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,eAAO,MAAM,6BAA6B,EAAE,aAAa,CACvD,EAAE,EACF,wBAAwB,CA6CzB,CAAC"}
+{"version":3,"file":"command-object.d.ts","sourceRoot":"","sources":["../../../../../../packages/nx/src/command-line/configure-ai-agents/command-object.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAGtC,MAAM,WAAW,wBAAwB;IACvC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,KAAK,CAAC;CACtC;AAED,eAAO,MAAM,6BAA6B,EAAE,aAAa,CACvD,EAAE,EACF,wBAAwB,CA2DzB,CAAC"}

package/src/command-line/configure-ai-agents/command-object.js

@@ -18,14 +18,28 @@ exports.yargsConfigureAiAgentsCommand = {
         default: true,
     })
         .option('check', {
-        type: 'boolean',
-        description: 'Check if any configured agents are out of date and need to be updated. Does not make any changes.',
-        default: false,
+        type: 'string',
+        description: 'Check agent configurations. Use --check or --check=outdated to check only configured agents, or --check=all to include unconfigured/partial configurations. Does not make any changes.',
+        coerce: (value) => {
+            // --check (no value)
+            if (value === '')
+                return 'outdated';
+            // --check=true
+            if (value === 'true')
+                return 'outdated';
+            // --no-check or --check=false
+            if (value === 'false')
+                return false;
+            // --check=all or --check=outdated
+            return value;
+        },
+        choices: ['outdated', 'all'],
     })
         .example('$0 configure-ai-agents', 'Interactively select AI agents to update and configure')
         .example('$0 configure-ai-agents --agents claude gemini', 'Prompts for updates and and configuration of Claude and Gemini AI agents')
         .example('$0 configure-ai-agents --check', 'Checks if any configured agents are out of date and need to be updated')
-        .example('$0 configure-ai-agents --agents claude gemini --no-interactive', 'Configures and updates Claude and Gemini AI agents without prompts'),
+        .example('$0 configure-ai-agents --check=all', 'Checks if any agents are not configured, out of date or partially configured')
+        .example('$0 configure-ai-agents --agents claude gemini --no-interactive', 'Configures and updates Claude and Gemini AI agents without prompts'), // because of the coerce function
     handler: async (args) => {
         await (await Promise.resolve().then(() => require('./configure-ai-agents'))).configureAiAgentsHandler(args);
     },

package/src/command-line/configure-ai-agents/configure-ai-agents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"configure-ai-agents.d.ts","sourceRoot":"","sources":["../../../../../../packages/nx/src/command-line/configure-ai-agents/configure-ai-agents.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAI5D,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,wBAAwB,EAC9B,KAAK,UAAQ,GACZ,OAAO,CAAC,IAAI,CAAC,CA+Bf;AAED,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,IAAI,CAAC,CA2Mf"}
+{"version":3,"file":"configure-ai-agents.d.ts","sourceRoot":"","sources":["../../../../../../packages/nx/src/command-line/configure-ai-agents/configure-ai-agents.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAI5D,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,wBAAwB,EAC9B,KAAK,UAAQ,GACZ,OAAO,CAAC,IAAI,CAAC,CA+Bf;AAED,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,IAAI,CAAC,CAyOf"}